跳到主要内容

查询钱包票据(Boleto)

查询钱包票据将返回与钱包关联的银行票据信息,包括条形码和可键入行。

注意

钱包票据仅在第一张账单结账后才会生成

Request

ENDPOINT
/v2/invoice/wallet/WALLET_KEY/wallet_bank_slip
MÉTODO
GET

路径参数

字段类型描述字符数
wallet_keyuuidv4UUID v4 格式的钱包唯一密钥36

Response

STATUS
200
Response Body:票据详情
{
"wallet_bank_slip_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"wallet_bank_slip_status": "accepted",
"bank_slip_amount": 150.00,
"bank_slip_due_date": "2024-02-15",
"bank_slip_data": {
"barcode": "32991090000000150001234567890123456789012345",
"digitable_line": "32991234567890123456789012345678901234567890123"
}
}

响应体参数

字段类型描述字符数
wallet_bank_slip_key *uuidv4uuid v4 格式的钱包票据唯一识别密钥36
wallet_bank_slip_status *string票据状态wallet_bank_slip_status 枚举值
bank_slip_amount *float票据金额-
bank_slip_due_date *string票据到期日(YYYY-MM-DD 格式)10
bank_slip_data *object包含条形码和可键入行的票据数据bank_slip_data 对象

bank_slip_data 对象

字段类型描述字符数
barcode *string票据条形码44
digitable_line *string票据可键入行47

wallet_bank_slip_status 枚举值

枚举值描述
accepted票据已接受,等待登记确认
registered票据已登记,可供支付

错误响应

STATUS
4xx
Response Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
HTTP 代码
status
QI 代码
code
标题
title
描述(英文)
description
描述(葡文)
translation
404CIN000007Wallet not FoundWallet with key: abeca0d0-a09d-4b3b-a495-40b553422ced was not foundCarteira com a chave: abeca0d0-a09d-4b3b-a495-40b553422ced não foi encontrado
404CIN000093Not FoundWallet bank slip was not foundBoleto da carteira não foi encontrado