Skip to main content
POST
/
pix
/
v1
/
payment
Create a PIX Payment
curl --request POST \
  --url https://api.pagou.ai/pix/v1/payment \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <api-key>' \
  --data '
{
  "type": "PIX",
  "payer": {
    "fullName": "<string>",
    "document": "<string>",
    "contact": {
      "mail": "[email protected]",
      "phone": "<string>"
    },
    "address": {
      "zipCode": "<string>",
      "street": "<string>",
      "number": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "<string>",
      "neighboor": "<string>",
      "neighborhood": "<string>"
    }
  },
  "transaction": {
    "value": 1,
    "description": "<string>",
    "expirationTime": 123,
    "dueDate": "<string>",
    "externalId": "<string>"
  },
  "splits": [
    {
      "pixKey": "<string>",
      "pixKeyType": "DOCUMENT",
      "document": "<string>",
      "percent": 50,
      "amount": 1,
      "externalId": "<string>"
    }
  ]
}
'
{
  "transactionId": "trn_2d02fb2dbfa5479bbd8ec8ad5d629b9e",
  "status": "WAITING_PAYMENT",
  "pixQrCode": "00020101021226830014br.gov.bcb.pix2558example.com/pix/33f8fcb9-54aa-4f2c-8a66-466067f225cb5204000053039865802BR5921PAGOU SANDBOX TESTE6008SaoPaulo62070503***6304D17A",
  "pixCode": "000201010212...6304D17A",
  "generateTime": "2026-02-06T19:52:13.295Z",
  "expirationDate": "2026-02-06T20:52:13.295Z",
  "paymentLink": null
}

Authorizations

apiKey
string
header
required

Body

application/json
type
enum<string>
required
Available options:
PIX
payer
object
required
transaction
object
required
splits
object[]

Response

Success

transactionId
string
required
status
enum<string>
required
Available options:
IN_ANALYSIS,
WAITING_CONFIRMATION,
WAITING_PAYMENT,
WAITING_WITHDRAW,
WITHDRAW_REQUEST,
WITHDRAW_PAID,
WEBHOOK_UPDATED,
WEBHOOK_ERROR,
PAID,
CANCELLED,
REVERSED,
REFUND,
REFUND_IN,
REFUND_OUT,
SOFT_REFUND,
ERROR,
PENDING_APPROVAL,
APPROVED,
DECLINED
pixQrCode
string
required
pixCode
string
required
generateTime
string
required
expirationDate
string
required