Skip to main content
POST
/
transparents
/
create
Criar QRCode PIX
curl --request POST \
  --url https://api.abacatepay.com/v2/transparents/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "PIX",
  "data": {
    "amount": 10000
  }
}
'
{
  "data": {
    "id": "pix_char_123456",
    "amount": 100,
    "status": "PENDING",
    "devMode": true,
    "brCode": "00020101021226950014br.gov.bcb.pix",
    "brCodeBase64": "data:image/png;base64,iVBORw0KGgoAAA",
    "platformFee": 80,
    "createdAt": "2025-03-24T21:50:20.772Z",
    "updatedAt": "2025-03-24T21:50:20.772Z",
    "expiresAt": "2025-03-25T21:50:20.772Z",
    "metadata": {}
  },
  "error": null,
  "success": true
}

Requer a permissão CHECKOUT:READ.
Este endpoint cria um checkout transparente via PIX.
  • Envie sempre method como "PIX".
  • Os dados da cobrança ficam dentro do objeto data (incluindo amount, description, expiresIn, customer e metadata).
Veja o exemplo completo em Checkout Transparente na página de referência.

Authorizations

Authorization
string
header
required

Todas as requisições devem incluir sua chave de API no header Authorization usando o formato Bearer <abacatepay-api-key>. Sem esse header a requisição será rejeitada.

Saiba mais sobre como criar e usar chaves de API na documentação de autenticação.

Body

application/json
method
enum<string>
required

Método de pagamento. Hoje apenas PIX é suportado.

Available options:
PIX
data
object
required

Dados da cobrança PIX.

Response

QRCode Pix criado com sucesso

data
object
error
string | null
Example:

null

success
boolean

Se a requisição obteve sucesso ou não.

Example:

true