Cobrar no cartão

POST

/api/partner/v1/credit-card

Cobra usando um token selado emitido em POST /card-tokens.

O que NÃO pode ir no corpo

Os campos abaixo são proibidos e devolvem 422 se enviados:

Campo	Por quê
`card.number`	PAN só trafega em `/card-tokens`
`card.cvv`	idem
`three_ds_data`	3DS é exclusivo do checkout próprio

O bloco `device` é obrigatório

Descreve o comprador, não o seu servidor. O ip da requisição é o da
sua infraestrutura, e por isso não serve para as regras de antifraude —
device.ip precisa ser o IP real de quem está comprando.

Resposta

200 confirma que a cobrança foi submetida e devolve o
transaction_id. O resultado final (aprovada, recusada, estornada) chega
pelo webhook de transação; você também pode consultar
GET /transaction/{reference_id}.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200

application/json

Cobrança submetida. Não retente esta requisição: a cobrança já
existe do nosso lado.

Bodyapplication/json

🟠403

🟠409

🟠422

🔴500

🟠401Unauthorized

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

cURL

À vista (1x), sem splitParcelado em 6x com split

curl --location '/api/partner/v1/credit-card' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 149.9,
    "description": "Pedido #1234",
    "installments": 1,
    "webhook_url": "https://loja.exemplo.com.br/webhooks/syncpay",
    "card": {
        "token": "card_token.yV5IhEG7gIUgHyKnUTE2Uozams0JpjCpbc5it3NG-nw…"
    },
    "client": {
        "name": "Maria da Silva",
        "email": "maria@exemplo.com.br",
        "phone": "5511987654321",
        "document": {
            "type": "cpf",
            "number": "12345678901"
        }
    },
    "device": {
        "ip": "187.45.201.10",
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)…",
        "page_url": "https://loja.exemplo.com.br/checkout",
        "metadata": {
            "session_id": "sess_9f2c"
        }
    }
}'

Response Example

200 - ok

{
    "data": {
        "message": "Credit card payment request successfully submitted.",
        "transaction_id": "acfbabc5-bb8a-4459-aa05-7374c2e5e9ef"
    }
}

Modificado em 2026-08-11 13:15:21

Página anterior

Selar um cartão

Próxima página

Solicitação de depósito via Pix

Cobrar no cartão

O que NÃO pode ir no corpo#

O bloco device é obrigatório#

Resposta#

Requisição

Respostas

O que NÃO pode ir no corpo

O bloco `device` é obrigatório

Resposta