Explicação sobre o fluxo de captura automática
A criação de vendas com cartão com captura automatica, é realizada na rota POST /v1/charges/
Captura Automática - como e quando utilizar
A captura automática é a mais recomendada e utilizada pela grande maioria dos estabelecimentos, pois nesse modelo não é necessário se preocupar em efetuar a confirmação da autorização, já que o gateway irá realizar a ação automaticamente no mesmo dia.
Captura Automática sempre será padrão
Por padrão, caso não seja parametrizado a solicitação de captura manual, a nossa plataforma considera o fluxo automático. Dessa forma, não será necessário que o estabelecimento se preocupe em tomar qualquer ação.
Exemplo de request e response
Para realizar uma transação com captura manual, basta não informar na criação de venda parâmetro payments.capture
Caso a transação seja aprovada, ela terá os campos statuscomo PAID e detailed_statuscomo "CAPTURED"
{
"amount": 5000,
"order_id": "BR0000-31656366",
"order_info": "charge description",
"currency": "BRL",
"type": "PAYMENT",
"payments": [
{
"capture": null,
"payment_method": "card",
"amount": 5000,
"card": {
"number": "5970100300000067",
"exp_year": 2025,
"exp_month": 12,
"cvv": "1234",
"holder_name": "Suzanne Hane"
}
}
],
"customer": {
"name": "Alfonso Lesch",
"email": "[email protected]",
"phone": "5511985270748",
"birth_date": "2000-01-01",
"document_type": "CPF",
"document_number": "62286843023"
}
}{
"uuid": "61ec977e-93d7-4edb-baf7-f08dcd85f706",
"type": "PAYMENT",
"expiry_date": "2025-11-14T02:59:59Z",
"status": "PAID",
"order_id": "BR0000-31656366",
"order_info": "charge description",
"currency": "BRL",
"original_amount": 5000,
"amount": 5000,
"paid": 5000,
"due": 0,
"refunded": 0,
"attempts": 1,
"max_attempts": 5,
"drop_reason": "",
"surcharge": false,
"client_ip": null,
"soft_descriptor": null,
"enable_checkout_3ds": null,
"customer": {
"uuid": "f49c0e17-85e7-4e03-8da2-413dd21dd988",
"name": "Alfonso Lesch",
"email": "[email protected]",
"birth_date": "2000-01-01",
"phone": "5511985270748",
"mobile_phone": null,
"document_type": "CPF",
"document_number": "622******23",
"created_at": "2025-11-11T14:01:54Z",
"updated_at": "2025-11-11T14:01:54Z"
},
"transactions": [
{
"uuid": "8be8ac69-5c48-4623-bffa-4c208a3f8bf4",
"charge_uuid": "61ec977e-93d7-4edb-baf7-f08dcd85f706",
"gateway_id": "a67e175504bb447a957db7e337c56b28",
"amount": 5000,
"paid_amount": 5000,
"status": "PAID",
"payment_option": "CARD",
"payment_option_detail": "card",
"scheme": "MASTERCARD",
"external_id": "0123456789456789",
"transaction_id_reference": null,
"expected_capture_date": "2025-11-11T14:01:55Z",
"payment_at": "2025-11-11T14:01:55Z",
"captured_at": null,
"auth_num": "123456",
"auth_response_code": "0",
"operation_type": "DEBIT",
"extra": null,
"payment_number": "597010XXXXXX0067",
"payer_info": "Alfonso Lesch",
"expiry_month": 12,
"expiry_year": 2025,
"acquirer_network": "SUB",
"nsu": "654321",
"tid": "",
"token": null,
"create_token": false,
"detailed_status": "CAPTURED",
"currency": "BRL",
"document_type": "CPF",
"document_number": "622******23",
"installments": 1,
"sub_acquirer": 1002,
"has_auth_3ds": false,
"created_at": "2025-11-11T14:01:56Z",
"updated_at": "2025-11-11T14:01:56Z"
}
],
"created_at": "2025-11-11T14:01:54Z",
"updated_at": "2025-11-11T14:01:54Z"
}