post
https://sandbox.tbanks.com.br/pix/qrcode/dynamic-due-date
Através deste endpoint é possível criar um QR Code para pagamento com vencimento.
Corpo do Request
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| reusable | boolean | Não | Indica se o QR Code é reutilizável. |
| keyIdentifier | String | Não | Identificador da chave. Mutuamente excludente com keyValue. |
| keyValue | Double | Não | Valor da chave. Mutuamente excludente com keyIdentifier. |
| additionalInformation | Array | Não | Informações adicionais. |
| └── name | String | Sim | Nome da informação adicional. |
| └── value | Double | Sim | Valor da informação adicional. |
| personPayer | Object | Sim | Informações do pagador |
| └── streetName | String | Sim | Nome da rua do pagador |
| └── city | String | Sim | Cidade do pagador |
| └── postalCode | String | Sim | Código postal do pagador |
| └── uf | String | Sim | Estado do pagador |
| String | Sim | Email do pagador | |
| └── documentNumber | String | Sim | Numero do documento do pagador |
| └── name | String | Sim | Nome do pagador |
| └── tradingName | String | Sim | Nome comercial do pagador |
| discounts | Array | Não | Lista de descontos |
| └── date | Date | Sim | data do desconto |
| └── value | Double | Sim | Valor do desconto |
| value | Double | Sim | Valor da transação |
| interestValue | Double | Não | valor de juros |
| interestType | Enum | Não | Tipo de juros |
| discountValue | Double | Não | Valor do desconto |
| discountType | Enum | Não | Tipo do desconto |
| fineValue | Double | Não | Valor de multa |
| fineType | Enum | Não | Tipo de multa |
| reductionValue | Double | Não | Valor do abatimento |
| reductionType | Enum | Não | Tipo do abatimento |
| dueDate | Date | Sim | Data de vencimento |
| daysToExpire | Int | Sim | Dias para expiração a partir da data de vencimento |
| description | String | Não | Descrição da transação |
| transactionIdentifier | String | Sim | Identificador da transação |
| urlNotification | String | Sim | Url de notificação de status da transação |
| splitTaxType | Enum | Não | Informa o tipo de cobrança no split (PERCENTAGE ou FIXED), cobrará de acordo com o informado. PercentualValue será em R$ ou %. |
| splits | Array | Não | Informações sobre a divisão de valores. |
| └── accountIdentifier | String | Sim | Identificador da conta. |
| └── percentualValue | Number | Sim | Percentual do valor. |
| └── tax | Number | Não | Valor da taxa. |
| └──absorbsTaxDifference | boolean | sim | Caso o valor ultrapasse devido aos juros e multa, se irá cobrar desse participante o restante da taxa. |
| └──absorbsValueDifference | boolean | sim | Caso o valor ultrapasse devido aos juros e multa, se irá repassar o restante do valor para esse participante |
Exemplo de requisição
{
"reusable": false,
"keyIdentifier": "990f6a80-6e82-4d6d-ad12-269bb65a65a6",
"keyValue": "keyValue_afcd6a4ba24a",
"additionalInformation": [
{
"name": "name_3881a1c5e521",
"value": "value_77032fdd1cc9"
}
],
"personPayer": {
"streetName": "streetName_0a83cbfe6761",
"city": "city_7e2927150416",
"postalCode": "postalCode_123a2e09833b",
"uf": "uf_9282e2010dde",
"email": "email_0e5ded5dd979",
"documentNumber": "documentNumber_7a0e879a7dbc",
"name": "name_a714d1c2beea",
"tradingName": "tradingName_c92fb4ea9baf"
},
"discounts": [
{
"date": "2024-12-09",
"value": 0.00
}
],
"value": 0.00,
"interestValue": 0.00,
"interestType": "VALUE_PER_DAY",
"discountValue": 0.00,
"discountType": "FIXED_VALUE_UNTIL_THE_DATE",
"fineValue": 0.00,
"fineType": "FIXED_VALUE",
"reductionValue": 0.00,
"reductionType": "FIXED_VALUE",
"dueDate": "2024-12-09",
"daysToExpire": 0,
"description": "description_dfff8f3a2b99",
"transactionIdentifier": "transactionIdentifier_54cb5e7fea53",
"urlNotification": "urlNotification_c3a08cd75d31",
"hybridBill": false,
"splitTaxType": "FIXED",
"splits":[
{
"accountIdentifier":"030fb86b-6c4e-4b0b-9c2a-1dedf1061f35",
"percentualValue":0.5,
"tax":0.5
},
{
"accountIdentifier":"030fb86b-6c4e-4b0b-9c2a-1dedf1061f35",
"percentualValue":0.5,
"tax":0.5
}
]
}
Corpo do response
| Campo | Tipo | Descrição |
|---|---|---|
| identifier | String | Identificador da transação |
| description | String | Descrição da transação |
| copyAndPaste | String | Código de barras da transação |
| value | Double | valor da transação |
| expirationDate | Date | Data de expiração da transação |
| key | String | Chave da transação |
| keyType | String | Tipo de chave |