RebornDocs

Listar transações

gethttps://sandbox-api.rebornpay.io/v1/transactionsAuth obrigatória

Retorna lista paginada de transações do seller. Filtre por `status` (PENDING, PAID, FAILED, CANCELLED, REFUND_PENDING, REFUNDED).

Headers

X-Api-Keystringrequired

API Key do seller (header)

Query Parameters

pageintegeroptional

Página (zero-based)

sizeintegeroptional

Itens por página (máx. 100)

statusstringoptional

Filtrar por status

Responses

200Lista de transações
itemsarrayrequired
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

pageinteger · int32required
sizeinteger · int32required
totalItemsinteger · int64required
totalPagesinteger · int64required
hasNextbooleanrequired
hasPreviousbooleanrequired
isFirstbooleanrequired
isLastbooleanrequired
401API Key ausente ou inválida
itemsarrayrequired
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

pageinteger · int32required
sizeinteger · int32required
totalItemsinteger · int64required
totalPagesinteger · int64required
hasNextbooleanrequired
hasPreviousbooleanrequired
isFirstbooleanrequired
isLastbooleanrequired
curl -X GET 'https://sandbox-api.rebornpay.io/v1/transactions' \  -H 'X-Api-Key: $API_KEY'
200Response example
{
  "items": [
    {
      "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": null,
          "branch": null,
          "account": null,
          "accountType": null
        }
      },
      "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": null,
          "amount": null,
          "originalAmount": null,
          "status": null,
          "requestedAt": null,
          "completedAt": null
        }
      ],
      "idempotencyKey": "string",
      "pendingAction": {
        "clientSecret": "string",
        "nextActionType": "challenge",
        "provider": "reborn",
        "publishableKey": "string",
        "url": "https://authenticate.example/3ds/challenge"
      },
      "feeAmount": 1,
      "netAmount": 1,
      "splits": [
        {
          "sellerId": null,
          "amount": null,
          "percentage": null,
          "feeAmount": null,
          "netAmount": null,
          "chargeProcessingFee": null,
          "liable": null,
          "status": null
        }
      ],
      "card": {
        "token": "pm_123"
      }
    }
  ],
  "page": 1,
  "size": 1,
  "totalItems": 1,
  "totalPages": 1,
  "hasNext": false,
  "hasPrevious": false,
  "isFirst": false,
  "isLast": false
}