Inicia uma nova sessão de checkout com base nos dados fornecidos na requisição. Este endpoint valida os dados do request, cria a sessão de checkout e retorna as informações da sessão criada.
POST /v2/checkout/init · versão da spec v2 · coleção Postman e spec
Corpo da requisição
application/json
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
buyerId | string (uuid) | não | |
amount | integer (int32) | não | |
externalReference | string | não | |
sellerId | string (uuid) | não | |
splitRuleId | string (uuid) | não | |
splitRequest | SplitRequest | não | |
currency | string | não | |
transactionType | TransactionType | não | |
preSelectedPaymentMethod | PaymentMethod | não | |
installments | integer (int32) | não | |
preSelectedInstallments | integer (int32) | não | |
metadata | object | não |
Respostas
| Status | Descrição | Formato |
|---|---|---|
| 200 | OK | text/plain, application/json, text/json |
| 400 | Bad Request | application/problem+json |
| 401 | Unauthorized | application/problem+json |
Respostas de erro seguem o Problem Details (RFC 9457): trate pelo campo code e consulte o catálogo de erros.
Exemplo
curl -X POST "https://api-payments.sand-fintech.com/v2/checkout/init" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d @corpo.json