Quickstart

Beta — o contrato da 1.0 em evolução, ainda não em produção. Os campos podem mudar até o lançamento.

Em modo test você integra o fluxo completo — inclusive recebendo o webhook assinado — sem mover um centavo. Troque pk_test_/sk_test_ por pk_live_/sk_live_ para produção.

Crie um depósito

curl -X POST https://api.swytchpay.app/v1/deposits \
  -H "x-api-key: pk_test_xxx" \
  -H "x-api-secret: sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "MXN",
    "payment_method": "SPEI",
    "external_id": "orden-42",
    "payer": { "name": "Juan Pérez", "email": "juan@ok.mx", "document": "PEGJ850315HDFRRN01" }
  }'

Resposta 201:

{ "id": "dep_…", "status": "PENDING", "flow": "REDIRECT", "charge": { "type": "spei", "redirect_url": "https://checkout…" } }

.O charge traz o que o pagador usa, e ele muda com o trilho: o emv no PIX, uma redirect_url nos trilhos LATAM. Sem currency, o default é BRL (PIX).

Registre seu webhook

curl -X POST https://api.swytchpay.app/v1/webhooks \
  -H "x-api-key: pk_test_xxx" -H "x-api-secret: sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "minha corretora", "url": "https://suacorretora.com/webhooks/swytch" }'

A resposta traz o secret (whsec_…) uma única vez — guarde para validar a assinatura.

Simule o pagamento (test)

curl -X POST https://api.swytchpay.app/v1/test/deposits/dep_xxx/pay \
  -H "x-api-key: pk_test_xxx" -H "x-api-secret: sk_test_xxx"

Isso roda o fluxo real (status → PAID, crédito no saldo na moeda do depósito) e dispara o webhook deposit.paid assinado para a sua URL.

Confira o saldo

curl https://api.swytchpay.app/v1/balance \
  -H "x-api-key: pk_test_xxx" -H "x-api-secret: sk_test_xxx"
# { "mxn": { "available": 48500, ... }, "brl": { ... } }

Pronto: você criou, pagou e recebeu a confirmação assinada. O saldo em peso fica acumulado até você converter para USDT.

Introdução

API