重新发送银行票据支付双因素身份验证令牌
此端点用于重新发送银行票据支付的身份验证令牌。
银行票据
这是常规银行票据(数字行不以数字8开头)。在银行间支付结算所(CIP/Núclea)注册,可在巴西中央银行授权的金融和支付机构付款。
Request
请求端点
ENDPOINT
/account/ACCOUNT_KEY/payment/PAYMENT_KEY/bank_slip/resend_tokenMÉTODO
PATCH请求路径参数
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
account_key * | uuid4 | 账户唯一标识键。 | 36 |
payment_key * | uuid4 | 支付唯一标识键。 | 36 |
Body 参数
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
contact_type | enumerator | 身份验证令牌发送方式 | contact_type 枚举值 |
说明
若未发送 contact_type,令牌将以原始请求方式发送。
| 枚举值 | 描 述 |
|---|---|
| sms | 通过短信发送至手机 |
| 通过电子邮件发送 |
Response
成功响应
STATUS
200Response Body: 令牌已成功重发
{
"payment_key": "c4325104-d60b-44f3-aae4-49155564a2ea",
"request_control_key": "b713b2f6-2f48-4d18-b0c9-7186e4edf189",
"payer_name": "COOPERATIVA INDUSTRIAL MURILO",
"payer_document_number": "00037025000160",
"source_account_key": "6dc89d57-fac7-4643-b151-cd2ca0a7f68f",
"transaction_key": "4e80070a-a0bb-4be2-8178-55fbd73a3704",
"transaction_revert_key": null,
"paid_amount": 1050.1,
"payment_date": "2024-04-03",
"payment_type": "bank_slip",
"bank_slip": {
"bank_slip_key": "95080ffd-3ac5-48d7-b3fe-659e4aaba81a",
"barcode": "00193967000009910000000003615574000000002417",
"digitable_line": "00190000090361557400500000024174396700000991000",
"payer_name": "COOPERATIVA TESTE",
"payer_document_number": "00037025000160",
"beneficiary_name": "TESTE EQUIPAMENTOS E SERVICOS LTDA",
"beneficiary_trading_name": "TESTE EQUIPAMENTOS E SERVICOS LTDA",
"beneficiary_document_number": "52069937000117",
"beneficiary_bank_ispb": "00000000",
"guarantor_name": null,
"guarantor_document_number": null,
"expiration_date": "2024-03-29",
"max_payment_data": "2026-03-29",
"partial_payment_indicator": "allowed",
"registered_payment_amount": 9029.0,
"nominal_amount": 9910.0,
"total_amount": 10129.1,
"rebate_amount": 0.0,
"discount_amount": 0.0,
"fine_amount": 0.0,
"interest_amount": 219.1
},
"collection_slip": null,
"payment_status": "pending_2fa_approval"
}
Response Body 参数
| 字段 | 类型 | 描述 |
|---|---|---|
payment_key * | uuid4 | 支付唯一标识键。 |
request_control_key * | uuid4 | 客户请求唯一标识键。 |
payer_name * | string | 实际付款人名称。 |
payer_document_number * | string | 实际付款人文件号码(CPF/CNPJ)。 |
source_account_key * | uuid4 | 被扣款账户密钥。 |
transaction_key * | uuid4 | 支付交易密钥。 |
transaction_revert_key | uuid4 | 支付冲销交易密钥。 |
paid_amount * | number | 实际支付金额。 |
payment_date * | string | 支付日期。 |
payment_type * | enum | 支付类型。 |
bank_slip | object | 银行票据。 |
collection_slip | object | 征税发票。 |
payment_status * | enum | 支付状态。 |
payment_type 枚举值
| 枚举值 | 类型 | 描述 |
|---|---|---|
bank_slip | string | 银行票据 |
collection_slip | string | 征税发票 |
警告
collection_slip 枚举值不适用于银行票据流程,同样 collection_slip 对象始终为空。
payment_status 枚举值
| 枚举值 | 描述 |
|---|---|
pending_2fa_approval | 待双因素审批 |
bank_slip 对象
| 字段 | 类型 | 描述 |
|---|---|---|
barcode * | string | 条形码。 |
digitable_line * | string | 数字行。 |
payer_name * | string | 付款人名称。 |
payer_document_number * | string | 付款人文件号码(CPF/CNPJ)。 |
beneficiary_name * | string | 受益人名称。 |
beneficiary_trading_name | string | 受益人商业名称。 |
beneficiary_document_number * | string | 受益人文件号码(CPF/CNPJ)。 |
beneficiary_bank_ispb * | string | 受益人银行 ISPB 代码。 |
guarantor_name | string | 保证人名称。 |
guarantor_document_number | string | 保证人文件号码(CPF/CNPJ)。 |
expiration_date * | string | 到期日期。 |
max_payment_date * | string | 最大支付日期。 |
partial_payment_indicator * | enum | 部分付款指示符。 |
registered_payment_amount | string | 已登记的总支付金额。 |
nominal_amount * | number | 原始金额。 |
total_amount * | number | 总金额。 |
rebate_amount * | number | 折扣金额。 |
discount_amount * | number | 优惠金额。 |
fine_amount * | number | 罚款金额。 |
interest_amount * | number | 利息金额。 |
partial_payment_indicator 枚举值
| 枚举值 | 类型 | 描述 |
|---|---|---|
allowed | string | 允许 |
not_allowed | string | 不允许 |
错误响应
STATUS
4XXResponse Body
{
"title": "Título",
"description": "Description in english",
"translation": "Descrição em português",
"code": "Código"
}
| HTTP 代码 | QI 代码 | 标题 | 描述(英文) | 描述(葡文) |
|---|---|---|---|---|
| 403 | BIP000010 | Forbidden | User is not allowed to do this action | Usuário não tem autorização para fazer essa ação |
| 404 | BIP000011 | Not Found | The source account key was not found. | A chave da conta de origem não foi encontrada. |
| 400 | BIP000012 | Bad Request | It was not possible to consult the source account at this time. Please try again in a few minutes. | Não foi possível consultar a conta de origem neste momento. Por favor, tente novamente em alguns minutos. |
| 400 | BIP000013 | Bad Request | The source account is closed. | A conta de origem está fechada. |
| 400 | BIP000014 | Bad Request | The source account is blocked. | A conta de origem está bloqueada. |
| 404 | BIP000056 | Not Found | Payment not found. | Pagamento não encontrado. |
| 400 | BIP000057 | Bad Request | Payment status is not pending approval. | Status de pagamento não é de aprovação pendente. |
| 400 | BIP000062 | Bad Request | Payment type is not bank slip. | Tipo de pagamento não é boleto. |
| 400 | BIP000064 | Bad Request | Error resending verification token | Erro ao reenviar token de verificação |
| 400 | BIP000065 | Bad Request | Payment verification time window exceeded. | Janela de tempo de verificação de pagamento excedida. |