Confirmar transação após 3DS

posthttps://sandbox-api.rebornpay.io/v1/transactions/{id}/3ds/confirmAuth obrigatória

Após o desafio 3DS no browser, confirma o status da transação. Com publishable key (pk_), envie pendingAction.clientSecret no body.

Headers

X-Api-Keystringrequired

API Key do seller (header)

Path Parameters

idstringrequired

Body

application/json

clientSecretstringoptional

clientSecret devolvido em pendingAction

Responses

200OK

idstring · uuidrequired

UUID da transação

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

statusstring · enumrequired

Status atual

Example: PENDING

PENDINGPAIDFAILEDCANCELLEDREFUND_PENDINGREFUNDED

paymentMethodstring · enumrequired

Método de pagamento

Example: PIX

PIXCREDIT_CARDDEBIT_CARD

amountinteger · int64required

Valor em centavos

Example: 10000

currencystringrequired

Moeda (ISO 4217)

Example: BRL

descriptionstringoptional

Descrição da transação

Example: Pedido #1234

customerobjectoptional

Dados do comprador

namestringoptional

Nome do comprador

Example: João da Silva

emailstringoptional

E-mail do comprador

Example: joao@email.com

documentstringoptional

Documento mascarado

Example: ***456789-**

payerobjectoptional

Dados de quem pagou

namestringoptional

Nome do pagador

Example: Maria Souza

documentstringoptional

Documento mascarado

Example: ***456789-**

bankobjectoptional

Conta de origem do pagamento

ispbstringoptional

ISPB da instituição

Example: 22896431

branchstringoptional

Agência

Example: 1

accountstringoptional

Número da conta

Example: 308112970

accountTypestringoptional

Tipo da conta

Example: CHECKING_ACCOUNT

paymentDetailsobjectoptional

Detalhes do PIX gerado

qrCodestringoptional

Payload EMV (copia e cola)

Example: 00020126580014br.gov.bcb.pix...

qrCodeUrlstringoptional

URL da imagem do QR Code

Example: https://qrcode.example.com/...

expiresAtstring · date-timeoptional

Data/hora de expiração do QR Code (UTC)

endToEndIdstringoptional

End-to-end id (E2E) do PIX pago. Nulo enquanto o pagamento não é confirmado e em cobranças que não são PIX.

Example: E12345678202610091800abcd

createdAtstring · date-timerequired

Data/hora de criação (UTC)

updatedAtstring · date-timerequired

Data/hora da última atualização (UTC)

paidAtstring · date-timeoptional

Data/hora do pagamento confirmado (UTC). Nulo enquanto pendente.

refundsarrayrequired

Histórico de estornos da transação

idstring · uuidrequired

UUID do estorno

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

amountinteger · int64required

Valor estornado nesta operação, em centavos

Example: 5000

originalAmountinteger · int64required

Valor original da transação no momento do estorno, em centavos

Example: 10000

statusstring · enumrequired

Status do estorno

Example: COMPLETED

PENDINGCOMPLETEDFAILED

requestedAtstring · date-timerequired

Data/hora da solicitação do estorno (UTC)

completedAtstring · date-timeoptional

Data/hora da confirmação do estorno (UTC). Nulo enquanto pendente.

idempotencyKeystringoptional

Chave de idempotência da criação (enviada no header ou gerada pelo servidor)

pendingActionobjectoptional

Ação adicional no browser (ex: 3DS)

clientSecretstringrequired

Segredo do cliente para concluir o 3DS no browser

nextActionTypestring · enumoptional

Tipo da próxima ação 3DS

Example: challenge

challengeredirect

providerstringoptional

Fluxo Reborn

Example: reborn

publishableKeystringoptional

Chave publicável do cliente 3DS Reborn para esta cobrança

urlstringoptional

URL do desafio 3DS. Redirecione o browser do comprador para concluir a autenticação. Depois do retorno em returnUrl, confirme a transação.

Example: https://authenticate.example/3ds/challenge

feeAmountinteger · int64optional

Taxa debitada do seller, em centavos

netAmountinteger · int64optional

Valor líquido creditado ao seller, em centavos

splitsarrayrequired

Regras de split de receita (vazio quando a transação não tem split)

sellerIdstring · uuidrequired

Seller recebedor

amountinteger · int64required

Valor destinado ao recebedor, em centavos

percentagenumberrequired

Percentual sobre o bruto

feeAmountinteger · int64required

Taxa de processamento absorvida por este recebedor, em centavos

netAmountinteger · int64required

Valor líquido creditado ao recebedor, em centavos

chargeProcessingFeebooleanrequired

Se este recebedor absorve taxa de processamento

liablebooleanrequired

Se este recebedor é responsável por estorno/chargeback

statusstring · enumrequired

Status da parcela

PENDINGPROCESSEDSETTLEDFAILEDREVERSED

cardobjectoptional

Cartão Stripe salvo para uma nova cobrança com card.token

tokenstringrequired

PaymentMethod reutilizável (`pm_…`). Envie em card.token.

Example: pm_123

curl -X POST 'https://sandbox-api.rebornpay.io/v1/transactions/{id}/3ds/confirm' \  -H 'X-Api-Key: $API_KEY' \  -H 'Content-Type: application/json'

200Response example

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "PENDING",
  "paymentMethod": "PIX",
  "amount": 10000,
  "currency": "BRL",
  "description": "Pedido #1234",
  "customer": {
    "name": "João da Silva",
    "email": "joao@email.com",
    "document": "***456789-**"
  },
  "payer": {
    "name": "Maria Souza",
    "document": "***456789-**",
    "bank": {
      "ispb": "22896431",
      "branch": "1",
      "account": "308112970",
      "accountType": "CHECKING_ACCOUNT"
    }
  },
  "paymentDetails": {
    "qrCode": "00020126580014br.gov.bcb.pix...",
    "qrCodeUrl": "https://qrcode.example.com/...",
    "expiresAt": "2025-01-15T10:30:00Z",
    "endToEndId": "E12345678202610091800abcd"
  },
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:00Z",
  "paidAt": "2025-01-15T10:30:00Z",
  "refunds": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "amount": 5000,
      "originalAmount": 10000,
      "status": "COMPLETED",
      "requestedAt": "2025-01-15T10:30:00Z",
      "completedAt": "2025-01-15T10:30:00Z"
    }
  ],
  "idempotencyKey": "string",
  "pendingAction": {
    "clientSecret": "string",
    "nextActionType": "challenge",
    "provider": "reborn",
    "publishableKey": "string",
    "url": "https://authenticate.example/3ds/challenge"
  },
  "feeAmount": 1,
  "netAmount": 1,
  "splits": [
    {
      "sellerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "amount": 1,
      "percentage": 1,
      "feeAmount": 1,
      "netAmount": 1,
      "chargeProcessingFee": false,
      "liable": false,
      "status": "PENDING"
    }
  ],
  "card": {
    "token": "pm_123"
  }
}