Contas e regras
Contas conectadas são as suas contas no Mercado Pago, Asaas, Efí e Stripe. Regras decidem por qual delas cada cobrança passa. Para o passo a passo, veja Conectar contas e Regras.
Rotas
| Rota | ||
|---|---|---|
GET |
/providers |
contas que dá para conectar |
GET / POST |
/provider-accounts |
listar / conectar |
PATCH / DELETE |
/provider-accounts/{id} |
alterar / desconectar |
GET / POST |
/routing-rules |
listar / criar regras |
PATCH / DELETE |
/routing-rules/{id} |
alterar / apagar |
POST |
/routing/simulate |
testar { method, amount, installments? } |
No campo fees.card, pct e fixed descrevem a taxa de 1x. Use installments para sobrescrever parcelas específicas, por exemplo "installments": { "3": { "pct": 3.49, "fixed": 49 } }. Os valores fixos são em centavos. Parcelas sem entrada própria usam a taxa de 1x; só são aceitas quantidades dentro do limite do provedor.
Para contas cujo provedor oferece Pix Automático, use pix_automatic_status ao conectar ou editar: "available" (liberado nessa conta), "unavailable" (não liberado) ou "unknown" (ainda não confirmado, padrão). A resposta da conta devolve o mesmo campo. A SuyPay não tenta criar novas autorizações em contas marcadas como indisponíveis; uma autorização bem-sucedida atualiza a situação para available.
Testar uma regra
POST /routing/simulate responde por qual conta uma venda passaria, sem cobrar nada:
Para cartão, envie installments de 1 a 21 para comparar as taxas daquela quantidade de parcelas. A resposta só inclui contas que aceitam esse parcelamento.
curl -X POST https://api.suypay.com/v1/routing/simulate \
-H "Authorization: Bearer suy_test_..." \
-H "Content-Type: application/json" \
-d '{ "method": "boleto", "amount": 200000 }'