创建静态 PIX QR 码
静态 QR 码适用于不知道付款方身份、付款时间和付款人数量的支付场景。基本上,它由经过编码的密钥(可选含金额)组成,因为只引用密钥,所以可以被多次支付。
请求
ENDPOINT
/account/ACCOUNT_KEY/alias/ALIAS_KEY/qrcodeMÉTODO
POST请求体:静态 QR 码
{
"request_control_key": "8a923886-afce-4116-ac1f-69bdffcf8da9",
"qr_code_type": "static",
"pix_key": "joaosilva@gmail.com",
"amount": 10.25,
}
请求体参数
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
request_control_key * | string | 请求的唯一 UUID4 标识符。 | - |
qr_code_type * | string | QR 码类型。 | "static" |
pix_key * | string | 代表交易目标账户的 PIX 密钥。 | - |
amount | float | QR 码金额。 | 如未提供,由付款方填写。 |
响应
STATUS
201 Created响应体:创建静态 QR 码
{
"request_control_key": "037b46b1-0c67-4c0d-aac3-1e395dfdcb10",
"base_64_payload": "<BASE64 DA URI DO PIX COPIA E COLA>"
}
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
request_control_key * | string | 请求的唯一 UUID4 标识符。 | - |
base_64_payload * | string | Base64 格式的 QR 码支付 URL。 | - |
STATUS
400响应体
{
"title": "Bad Request",
"description": "Invalid payload for QR Code creation.",
"translation": "Payload inválido para a criação de QR Code.",
"code": "QRI000003"
}