Criar QRCode PIX

curl --request POST \
  --url https://api.aobapay.com/v1/charge/pix/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 200,
  "externalID": "12345678900",
  "expiration": 3600,
  "comment": "<string>",
  "name": "João da Silva",
  "email": "[email protected]",
  "phone": "11987654321",
  "document": "12345678900",
  "postbackUrl": "https://webhook.example.com/pix"
}
'

{
  "error": "<unknown>",
  "status": 200,
  "data": {
    "id": "ch_123456",
    "externalID": "pedido-123",
    "brCode": "00020101021226950014br.gov.bcb.pix",
    "brCodeImageUrl": "https://api.aobapay.com/v1/qrcode/ch_abb6bc4f-f55d-45ff-8b",
    "amount": 200,
    "comment": "Pagamento para pedido #123",
    "expiration": 300,
    "fee": 78,
    "expiresAt": "2025-09-25 13:07:27",
    "status": "PENDING",
    "customer": {
      "id": "cus_2243f989-f044-49cc-84db-3ff9e4908dde",
      "name": "João da Silva",
      "document": "12345678900",
      "email": "[email protected]",
      "phone": "+5511987654321"
    },
    "createdAt": "2025-09-25 13:07:27",
    "updatedAt": "2025-09-25 13:07:27"
  }
}

POST

charge

pix

create

Criar QRCode PIX

curl --request POST \
  --url https://api.aobapay.com/v1/charge/pix/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 200,
  "externalID": "12345678900",
  "expiration": 3600,
  "comment": "<string>",
  "name": "João da Silva",
  "email": "[email protected]",
  "phone": "11987654321",
  "document": "12345678900",
  "postbackUrl": "https://webhook.example.com/pix"
}
'

{
  "error": "<unknown>",
  "status": 200,
  "data": {
    "id": "ch_123456",
    "externalID": "pedido-123",
    "brCode": "00020101021226950014br.gov.bcb.pix",
    "brCodeImageUrl": "https://api.aobapay.com/v1/qrcode/ch_abb6bc4f-f55d-45ff-8b",
    "amount": 200,
    "comment": "Pagamento para pedido #123",
    "expiration": 300,
    "fee": 78,
    "expiresAt": "2025-09-25 13:07:27",
    "status": "PENDING",
    "customer": {
      "id": "cus_2243f989-f044-49cc-84db-3ff9e4908dde",
      "name": "João da Silva",
      "document": "12345678900",
      "email": "[email protected]",
      "phone": "+5511987654321"
    },
    "createdAt": "2025-09-25 13:07:27",
    "updatedAt": "2025-09-25 13:07:27"
  }
}

Authorizations

Authorization

string

header

required

Cabeçalho de autenticação Bearer no formato Bearer <aobapay-api-key> onde <aobapay-api-key> é a sua chave de API.

Body

application/json

amount

number

required

Valor da cobrança em centavos.

Required range: x >= 200

Example:

200

externalID

string

ID externo para referência na sua aplicação.

Example:

"12345678900"

expiration

number

Tempo de expiração da cobrança em segundos.

Required range: x >= 300

Example:

3600

comment

string

Maximum string length: 35

name

string

Nome do pagador.

Example:

"João da Silva"

string

Email do pagador.

Example:

"[email protected]"

phone

string

Telefone do pagador.

Example:

"11987654321"

document

string

Documento do pagador (CPF ou CNPJ).

Example:

"12345678900"

postbackUrl

string

URL para receber notificações sobre o status do pagamento, dos eventos de cobrança paga, expirada e extornada.

Example:

"https://webhook.example.com/pix"

Response

QRCode Pix criado com sucesso

error

null

status

integer

Código de status HTTP.

Example:

200

data

object

Show child attributes

data.id

string

Identificador único do QRCode Pix.

Example:

"ch_123456"

data.externalID

string

Identificador único do QRCode Pix no seu sistema.

Example:

"pedido-123"

data.brCode

string

Código copia-e-cola do QRCode Pix.

Example:

"00020101021226950014br.gov.bcb.pix"

data.brCodeImageUrl

string

Imagem em Base64 do QRCode Pix.

Example:

"https://api.aobapay.com/v1/qrcode/ch_abb6bc4f-f55d-45ff-8b"

data.amount

number

Valor a ser pago.

Example:

200

data.comment

string

Comentário opcional sobre o QRCode Pix.

Example:

"Pagamento para pedido #123"

data.expiration

integer

Data de expiração do QRCode Pix em segundos.

Example:

300

data.fee

number

Taxas da plataforma

Example:

78

data.expiresAt

string

Data de expiração do QRCode Pix.

Example:

"2025-09-25 13:07:27"

data.status

enum<string>

Informação sobre o andamento do QRCode Pix.

Available options:

PENDING,

EXPIRED,

FAILED,

PAID,

REFUNDED

Example:

"PENDING"

data.customer

object

Dados do cliente associado ao QRCode Pix.

Show child attributes

data.customer.id

string

Identificador único do cliente.

Example:

"cus_2243f989-f044-49cc-84db-3ff9e4908dde"

data.customer.name

string

Nome do cliente.

Example:

"João da Silva"

data.customer.document

string

Documento do cliente (CPF ou CNPJ).

Example:

"12345678900"

data.customer.email

string

Endereço de e-mail do cliente.

Example:

"[email protected]"

data.customer.phone

string

Número de telefone do cliente.

Example:

"+5511987654321"

data.createdAt

string

Data de criação do QRCode Pix.

Example:

"2025-09-25 13:07:27"

data.updatedAt

string

Data de atualização do QRCode Pix.

Example:

"2025-09-25 13:07:27"

Buscar cobrança

⌘I

API Reference

Authorizations

Body

Response