创建 Pix 收款

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

amount*number

Amount in BRL. Must be >= 1.

Range1 <= value

callbackUrl?string

URL to receive transaction updated webhooks.

generatedName?string

Payer full name. Letters and spaces only.

generatedEmail?string

Payer email (optional).

generatedDocument?string

Payer CPF (11 digits) or CNPJ (14 digits), no punctuation.

expiresIn?number

Seconds until the QR Code expires. Default: 600.

Rangevalue <= 172000

clientReference?string

External reference (order, invoice, etc.).

Lengthlength <= 64

virtualAccount?string

Subconta virtual (até 50 caracteres) para correlacionar lojas, filiais, marketplaces. Volta no callback.

Lengthlength <= 50

Response Body

`application/json`

curl -X POST "https://api.payzu.processamento.com/v1/pix" \  -H "Content-Type: application/json" \  -d '{    "amount": 10.9  }'

{
  "id": "PAYZU20250817215911F49RDOBJ",
  "status": "PENDING",
  "amount": 10,
  "type": "DEPOSIT",
  "callbackUrl": "https://webhook.cool/",
  "qrCodeText": "00020126870014br.gov.bcb.pix2565qrcode.payzu.com.br/dynamic/d7790b91-3979-4ad5-9d96-ee941e5a42765204000053039865802BR5908PAYZUPLUS6009SAO PAULO62070503***63047EE4",
  "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUgAAAZAAAAGQCAYAAAC...",
  "qrCodeUrl": "https://pix.payzu.com.br/v1/pix/qr-code/PAYZU20250817215911F49RDOBJ",
  "generatedName": "John Doe",
  "generatedDocument": "12345678901",
  "generatedEmail": "john.doe@example.com",
  "serviceFeeCharged": 0.115,
  "payerName": null,
  "payerDocument": null,
  "payerInstitutionIspb": null,
  "payerInstitutionName": null,
  "payerAccountNumber": null,
  "receiverName": null,
  "receiverDocument": null,
  "receiverInstitutionIspb": null,
  "receiverInstitutionName": null,
  "receiverAccountNumber": "513579",
  "endToEndId": null,
  "createdAt": "2025-08-17T21:59:11.579Z",
  "updatedAt": "2025-08-17T21:59:11.579Z",
  "paidAt": null,
  "withdrawPixKey": null,
  "withdrawPixType": null,
  "clientReference": "order_12345",
  "refundEndToEndId": null,
  "refundAmount": null,
  "refundStatus": null,
  "refundReason": null,
  "refundDescription": null,
  "refundedAt": null,
  "cancellationReason": null
}

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "querystring/dateFrom Invalid input: expected string, received undefined",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing or invalid Bearer token",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}

创建 Pix 收款

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`