API PaySync

curl -X POST https://api.usepaysync.com/v1/payments \
  -H "Authorization: Bearer ps_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "665f1a2b3c4d5e6f7a8b9c0d",
    "callbackUrl": "https://seu-site.com/webhook"
  }'

{
  "paymentId": "psa_a1b2c3d4e5f6...",
  "status": "pending",
  "amountCents": 2990,
  "pix": {
    "brCode": "00020126580014br.gov.bcb.pix...",
    "qrCodeImage": "https://api.openpix.com.br/..."
  },
  "expiresAt": "2026-03-18T12:30:00.000Z"
}

Authorization: Bearer ps_live_sua_chave_aqui

{ "error": "Product not found or inactive" }

curl -X POST https://api.usepaysync.com/v1/products \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Plano Premium",
    "priceCents": 4990,
    "description": "Acesso mensal"
  }'

{
  "_id": "60f7b2a1c3e4d5f6a7b8c9d0",
  "name": "Plano Premium",
  "description": "Acesso mensal",
  "priceCents": 4990,
  "currency": "BRL",
  "active": true,
  "metadata": "{}",
  "createdAt": "2026-03-18T10:00:00.000Z"
}

{
  "products": [
    { "_id": "60f7...", "name": "Plano Premium", "priceCents": 4990, "currency": "BRL", "active": true, "createdAt": "..." }
  ]
}

{ "deleted": true }

curl -X POST https://api.usepaysync.com/v1/payments \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "665f1a2b3c4d5e6f7a8b9c0d",
    "callbackUrl": "https://seu-site.com/webhook",
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com"
    }
  }'

{
  "paymentId": "psa_a1b2c3d4e5f6...",
  "status": "pending",
  "amountCents": 4990,
  "currency": "BRL",
  "productName": "Produto Premium",
  "pix": {
    "brCode": "00020126580014br.gov.bcb.pix0136...",
    "qrCodeImage": "https://api.openpix.com.br/..."
  },
  "expiresAt": "2026-03-18T12:30:00.000Z"
}

{
  "paymentId": "psa_a1b2c3d4...",
  "status": "paid",
  "amountCents": 4990,
  "paidAt": "2026-03-18T12:05:00.000Z"
}

{
  "payments": [ ... ],
  "total": 42,
  "limit": 50,
  "offset": 0
}

curl -X POST https://api.usepaysync.com/v1/charges \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "valueCents": 1200,
    "description": "Pagamento avulso",
    "callbackUrl": "https://seu-site.com/webhook"
  }'

{
  "paymentId": "psc_a1b2c3d4e5f6...",
  "status": "pending",
  "amountCents": 1200,
  "currency": "BRL",
  "environment": "live",
  "pix": {
    "brCode": "00020126580014br.gov.bcb.pix0136...",
    "qrCodeImage": "https://api.openpix.com.br/..."
  },
  "expiresAt": "2026-03-18T12:30:00.000Z"
}

{
  "paymentId": "psc_a1b2c3d4...",
  "status": "paid",
  "amountCents": 1200,
  "currency": "BRL",
  "description": "Pagamento avulso",
  "customer": { "name": "", "email": "", "externalId": "" },
  "metadata": "{}",
  "paidAt": "2026-03-18T12:05:00.000Z",
  "expiresAt": "2026-03-18T12:30:00.000Z",
  "createdAt": "2026-03-18T12:00:00.000Z"
}

curl -X POST https://api.usepaysync.com/v1/split-charges \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amountCents": 10000,
    "description": "Venda compartilhada",
    "splits": [
      { "recipientEmail": "vendedor1@example.com", "percentage": 50 },
      { "recipientEmail": "vendedor2@example.com", "percentage": 50 }
    ],
    "customer": { "name": "Cliente", "email": "cliente@example.com" }
  }'

{
  "paymentId": "psplit_a1b2c3d4...",
  "status": "pending",
  "amountCents": 10000,
  "currency": "BRL",
  "environment": "live",
  "pix": {
    "brCode": "00020126360014BR.GOV.BCB.PIX...",
    "qrCodeImage": null
  },
  "splits": [
    { "recipientEmail": "ve***@example.com", "percentage": 50 },
    { "recipientEmail": "ve***@example.com", "percentage": 50 }
  ],
  "expiresAt": "2026-05-28T12:30:00.000Z"
}

{
  "paymentId": "psplit_a1b2c3d4...",
  "status": "paid",
  "amountCents": 10000,
  "gatewayFeeCents": 250,
  "netAmountCents": 9750,
  "currency": "BRL",
  "environment": "live",
  "pix": { "brCode": "..." },
  "splits": [
    {
      "recipientEmail": "ve***@example.com",
      "percentage": 50,
      "amountCents": 4875,
      "creditedAt": "2026-05-28T12:15:00.000Z"
    },
    {
      "recipientEmail": "ve***@example.com",
      "percentage": 50,
      "amountCents": 4875,
      "creditedAt": "2026-05-28T12:15:00.000Z"
    }
  ],
  "paidAt": "2026-05-28T12:15:00.000Z",
  "expiresAt": "2026-05-28T12:30:00.000Z",
  "createdAt": "2026-05-28T12:00:00.000Z"
}

{
  "orderCode": "JUE7Y9MPSX",
  "status": "pending",
  "amountCents": 4990,
  "currency": "BRL",
  "checkoutUrl": "https://checkout.stripe.com/...",
  "expiresAt": "2026-03-18T12:30:00.000Z"
}

{
  "orderCode": "JUE7Y9MPSX",
  "status": "paid",
  "amount": 49.90,
  "amountCents": 4990,
  "currency": "BRL",
  "description": "Pagamento Cartao",
  "checkoutUrl": null,
  "paidAt": "2026-03-18T12:05:00.000Z",
  "createdAt": "2026-03-18T12:00:00.000Z"
}

{
  "payments": [
    { "orderCode": "JUE7Y9MPSX", "status": "paid", "amountCents": 4990, "paidAt": "...", "createdAt": "..." }
  ],
  "total": 10,
  "limit": 50,
  "offset": 0
}

curl -X POST https://api.usepaysync.com/v1/subscriptions \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "665f1a2b3c4d5e6f7a8b9c0d",
    "customer": { "name": "João Silva" },
    "frequency": "MONTHLY",
    "dayGenerateCharge": 15,
    "callbackUrl": "https://seu-site.com/webhook"
  }'

{
  "paymentId": "psa_sub_a1b2c3d4...",
  "status": "pending",
  "type": "subscription",
  "subscriptionId": "sub_xyz...",
  "amountCents": 4990,
  "currency": "BRL",
  "productName": "Plano Premium",
  "frequency": "MONTHLY",
  "environment": "live",
  "pix": {
    "brCode": "00020126580014br.gov.bcb.pix...",
    "paymentLinkUrl": "https://openpix.com.br/pay/..."
  },
  "dayGenerateCharge": 15
}

curl -X GET "https://api.usepaysync.com/v1/subscriptions?limit=20&status=pending" \
  -H "Authorization: Bearer ps_live_..."

{
  "subscriptions": [
    {
      "paymentId": "psa_sub_a1b2c3d4...",
      "subscriptionId": "sub_xyz...",
      "status": "pending",
      "amountCents": 4990,
      "currency": "BRL",
      "productName": "Plano Premium",
      "customer": { "name": "João Silva", "email": "", "externalId": "user_123" },
      "metadata": "{}",
      "paidAt": null,
      "createdAt": "2026-03-18T10:00:00.000Z"
    }
  ],
  "total": 5,
  "limit": 20,
  "offset": 0
}

curl -X POST https://api.usepaysync.com/v1/sandbox/payments/psa_abc123/simulate-paid \
  -H "Authorization: Bearer ps_test_..."

{
  "sandbox": true,
  "availableCents": 12990,
  "pendingCents": 4990,
  "available": 129.9,
  "pending": 49.9
}

{
  "sandbox": true,
  "transactions": [
    {
      "paymentId": "psa_abc123",
      "source": "payment",
      "type": "one_time",
      "status": "paid",
      "amountCents": 4990
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

curl -X GET "https://api.usepaysync.com/v1/disputes?limit=20&status=aberta" \
  -H "Authorization: Bearer ps_live_..."

{
  "disputes": [
    {
      "id": "665f1a2b3c4d5e6f7a8b9c0d",
      "code": "MED-2024-001",
      "wooviDisputeId": "abc123...",
      "endToEndId": "E123456782024...",
      "orderCode": "JUE7Y9MPSX",
      "buyer": "João Silva",
      "product": "Produto Premium",
      "amount": 23.07,
      "reason": "Produto não recebido",
      "status": "aberta",
      "evidences": [],
      "resolvedAt": null,
      "createdAt": "2026-03-18T10:00:00.000Z"
    }
  ],
  "total": 3,
  "limit": 50,
  "offset": 0
}

curl -X GET https://api.usepaysync.com/v1/disputes/665f1a2b3c4d5e6f7a8b9c0d \
  -H "Authorization: Bearer ps_live_..."

{
  "id": "665f1a2b3c4d5e6f7a8b9c0d",
  "code": "MED-2024-001",
  "wooviDisputeId": "abc123...",
  "endToEndId": "E123456782024...",
  "orderCode": "JUE7Y9MPSX",
  "buyer": "João Silva",
  "buyerDiscordId": "",
  "product": "Produto Premium",
  "amount": 23.07,
  "reason": "Produto não recebido",
  "status": "aberta",
  "evidences": [
    { "url": "https://...", "description": "Comprovante", "correlationID": "MED-2024-001-EV1" }
  ],
  "resolvedAt": null,
  "createdAt": "2026-03-18T10:00:00.000Z"
}

curl -X POST https://api.usepaysync.com/v1/disputes/665f1a2b3c4d5e6f7a8b9c0d/evidence \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "documents": [
      {
        "url": "https://seu-site.com/comprovante.pdf",
        "description": "Comprovante de entrega",
        "correlationID": "MED-2024-001-EV1"
      }
    ],
    "textForPdf": "O cliente recebeu o produto em 15/03. Rastreio: BR123456789."
  }'

{
  "success": true,
  "uploaded": 2
}

curl -X POST https://api.usepaysync.com/v1/payouts \
  -H "Authorization: Bearer ps_live_<key>" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "pix",
    "amount": 100.00,
    "walletAddress": "loja@email.com"
  }'

{
  "id": "SAQ-API-A1B2C3D4",
  "code": "SAQ-API-A1B2C3D4",
  "method": "pix",
  "amount": 100.00,
  "status": "pending",
  "sandbox": false
}

curl -X POST https://api.usepaysync.com/v1/payouts \
  -H "Authorization: Bearer ps_live_<key>" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "ltc",
    "amount": 100.00,
    "cryptoAmount": 0.5,
    "walletAddress": "ltc1q..."
  }'

{
  "payouts": [
    {
      "id": "SAQ-API-A1B2C3D4",
      "code": "SAQ-API-A1B2C3D4",
      "method": "pix",
      "amount": 100.00,
      "cryptoAmount": null,
      "walletAddress": "12345***",
      "status": "pendente",
      "createdAt": "2026-04-27T12:00:00.000Z"
    }
  ]
}

GET https://api.usepaysync.com/api/developer/webhook-secret
Authorization: Bearer <seu_token_dashboard>

→ { "secret": "whk_a1b2c3d4..." }

import crypto from "node:crypto";
import express from "express";

const app = express();

// Importante: precisa do body cru. O JSON.parse vem depois da validação.
app.post("/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const signature = req.header("X-Webhook-Signature");
  const expected = crypto
    .createHmac("sha256", process.env.PAYSYNC_WEBHOOK_SECRET)
    .update(req.body)
    .digest("hex");

  // timing-safe compare
  const valid =
    signature &&
    signature.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));

  if (!valid) return res.status(401).send("invalid signature");

  const event = JSON.parse(req.body.toString());
  // ... processa event.event, event.paymentId, etc.
  res.json({ ok: true });
});

<?php
$payload = file_get_contents('php://input'); // body cru
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$secret = getenv('PAYSYNC_WEBHOOK_SECRET');
$expected = hash_hmac('sha256', $payload, $secret);

if (!hash_equals($expected, $signature)) {
  http_response_code(401);
  exit('invalid signature');
}

$event = json_decode($payload, true);
// ... processa $event['event'], $event['paymentId'], etc.
http_response_code(200);
echo json_encode(['ok' => true]);

POST https://seu-site.com/webhook
Content-Type: application/json
X-Webhook-Signature: a3f5b8c2e1d4f7a9b6c8d2e5f1a4b7c9d2e5f8a1b4c7d0e3f6a9b2c5d8e1f4a7

{
  "event": "payment.paid",
  "paymentId": "psa_a1b2c3d4...",
  "amountCents": 4990,
  "status": "paid",
  "paidAt": "2026-03-18T12:05:00.000Z",
  "customer": {
    "name": "João Silva",
    "email": "joao@email.com",
    "externalId": "user_123"
  },
  "metadata": "{\"orderId\": \"abc-123\"}"
}

{
  "event": "charge.paid",
  "paymentId": "psa_a1b2c3d4...",
  "amountCents": 4990,
  "status": "paid",
  "paidAt": "2026-03-18T12:05:00.000Z",
  "customer": { "name": "João Silva", "email": "joao@email.com" },
  "metadata": "{\"orderId\": \"abc-123\"}",
  "payer": "João Silva",
  "cpfCensored": "123.***.**1-23",
  "bank": "077 - Banco Inter",
  "endToEndId": "E1818773820260318120500abc12345"
}

POST https://seu-site.com/webhook
Content-Type: application/json
X-Webhook-Signature: a3f5b8c2e1d4f7a9b6c8d2e5f1a4b7c9d2e5f8a1b4c7d0e3f6a9b2c5d8e1f4a7

{
  "event": "card_payment.paid",
  "orderCode": "ORD-7K3B9X",
  "amount": 49.90,
  "status": "paid",
  "paidAt": "2026-03-18T12:05:00.000Z",
  "customer": { "name": "João Silva", "email": "joao@email.com" },
  "metadata": "{\"orderId\": \"abc-123\"}"
}

POST https://seu-site.com/webhook
Content-Type: application/json
X-Webhook-Signature: a3f5b8c2e1d4f7a9b6c8d2e5f1a4b7c9d2e5f8a1b4c7d0e3f6a9b2c5d8e1f4a7

{
  "event": "order.paid",
  "orderId": "665f1a2b3c4d5e6f7a8b9c0d",
  "orderCode": "ORD-7K3B9X",
  "total": 49.90,
  "paidAt": "2026-03-18T12:05:00.000Z",
  "acquirer": "cartwave"
}

POST https://seu-site.com/webhook
Content-Type: application/json
X-Webhook-Signature: hmac_sha256_...

{
  "event": "withdrawal.requested",
  "withdrawalId": "665f1a2b3c4d5e6f7a8b9c0d",
  "code": "SAQ-A1B2C3",
  "amount": 150.00,
  "method": "pix",
  "walletAddress": "email@exemplo.com",
  "status": "pendente",
  "requestedAt": "2026-03-18T14:00:00.000Z"
}

{
  "event": "withdrawal.completed",
  "withdrawalId": "665f1a2b3c4d5e6f7a8b9c0d",
  "code": "SAQ-A1B2C3",
  "amount": 150.00,
  "method": "pix",
  "walletAddress": "email@exemplo.com",
  "status": "concluido",
  "processedAt": "2026-03-18T15:30:00.000Z"
}

{
  "event": "withdrawal.denied",
  "withdrawalId": "665f1a2b3c4d5e6f7a8b9c0d",
  "code": "SAQ-A1B2C3",
  "amount": 150.00,
  "method": "pix",
  "walletAddress": "email@exemplo.com",
  "status": "negado",
  "processedAt": "2026-03-18T15:30:00.000Z"
}