Skip to main content
POST
/
v1
/
pix
/
in
/
qrcode
Criar cobrança PIX (QR Code imediato)
curl --request POST \
  --url https://api.ephra.io/v1/pix/in/qrcode \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amountInCents": 10000,
  "customer": {
    "documentType": "cpf",
    "document": "12345678909",
    "name": "Maria Silva",
    "email": "maria@email.com",
    "phone": "+5511999998888",
    "billingAddress": {
      "street": "<string>",
      "number": "<string>",
      "neighborhood": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zipCode": "<string>"
    }
  },
  "description": "Pedido #1234",
  "postbackUrl": "<string>",
  "items": [
    {
      "title": "Produto A",
      "tangible": false,
      "quantity": 1,
      "amountInCents": 10000,
      "shippingAddress": {
        "street": "<string>",
        "number": "<string>",
        "neighborhood": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zipCode": "<string>"
      }
    }
  ]
}
'
{
  "success": true,
  "message": "Transação criada com sucesso",
  "data": {
    "id": "clxabc123def456",
    "pix": {
      "emv": "00020126580014br.gov.bcb.pix...6304ABCD",
      "qrCode": "data:image/png;base64,iVBORw0KG..."
    },
    "status": "pending",
    "fees": 150
  }
}
Gera um QR Code PIX dinâmico, sem vencimento — ideal para checkout. A resposta traz o emv (copia e cola) e o qrCode (imagem PNG em base64). A cobrança nasce com status: "pending" e é confirmada por webhook.
Se você enviar items, o amountInCents deve ser igual à soma de amountInCents × quantity de cada item.
Visão conceitual e quando usar cada tipo de PIX em Guias › Pagamentos PIX.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
amountInCents
integer
required

Valor em centavos (> 0)

Example:

10000

​
customer
object
required
​
description
string
Example:

"Pedido #1234"

​
postbackUrl
string<uri>

Recebe webhooks só desta transação

​
seller
object
​
items
object[]

Response

Cobrança criada

​
success
boolean
Example:

true

​
message
string
Example:

"Transação criada com sucesso"

​
data
object