Bunne Docs
Cobranças

Concluir uma cobrança com 3-D Secure.

Conclui uma cobrança em requires_action depois que o cliente executa o desafio 3DS. Autoriza apenas na adquirente vinculada no momento do prepare; um confirm duplicado é um replay idempotente.

POST
/charges/{id}/confirm-3ds

Conclui uma cobrança em requires_action depois que o cliente executa o desafio 3DS. Autoriza apenas na adquirente vinculada no momento do prepare; um confirm duplicado é um replay idempotente.

Autorização

ApiKeyAuth
AutorizaçãoBearer <token>

Em: header

Parâmetros de caminho

id*string
Match^ch_[A-Za-z0-9]+$

Parâmetros de cabeçalho

Idempotency-Key?string
Tamanho1 <= length <= 255

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body em TypeScript.

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/charges/ch_xxx/confirm-3ds" \  -H "Idempotency-Key: order_123_attempt_1" \  -H "Content-Type: application/json" \  -d '{    "authentication_id": "string",    "result": {}  }'
{  "id": "string",  "object": "charge",  "status": "pending",  "amount_cents": 1,  "currency": "BRL",  "payment_method": "credit_card",  "capture_method": "automatic",  "captured": true,  "installments": 1,  "buyer": {    "name": "string",    "email": "user@example.com",    "phone": "string",    "document": "string",    "document_type": "cpf",    "ip": "string",    "address": {      "line_1": "string",      "line_2": "string",      "zip_code": "string",      "city": "string",      "state": "string",      "country": "string"    }  },  "acquirer_code": "string",  "acquirer_transaction_id": "string",  "authorization_code": "string",  "acquirer_return_code": "string",  "acquirer_return_message": "string",  "refused_reason": "string",  "next_action": {    "type": "three_ds_challenge",    "three_ds": {      "authentication_id": "string",      "acquirer": "string",      "sdk_payload": {}    }  },  "metadata": {},  "split": [    {      "recipient_seller_id": "string",      "amount_cents": 1    }  ],  "paid_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "request_id": "req_xxx",  "presentment": {    "currency": "USD",    "amount_cents": 0  },  "fx": {    "base_currency": "BRL",    "rate_micros": 0,    "quoted_at": "2019-08-24T14:15:22Z"  }}

Capturar uma cobrança autorizada. POST

Captura uma cobrança no cartão criada com capture_method=manual e status=authorized.

Consultar o saldo do seller. GET

Retorna o saldo pendente, disponível, reservado e passível de solicitação para uma API key com escopo de seller. Os valores já saem líquidos da rolling reserve retida: o que está em reserva não aparece em pending_cents nem em available_cents, e volta ao saldo na liberação. Exige a permissão balance:read e uma key com escopo de seller.