Explicação sobre o Pix do data de vencimento (CobV)
Recipes
📅
📅 Criando um Pix com vencimento
Open Recipe
A criação do Pix-cobV, é realizada na rota POST /v1/charges/
Pix-cobv
Pix cobrança com data de vencimento.
Esse tipo de Pix permite gerar um Código/Qr Code com data de vencimento.
A diferença é que, nesse modelo existe a possibilidade de configurar juros, multase descontos.
Através do objeto pix é possível definir data de vencimento, tipo de juros/multa/desconto (valor fixo ou percentual).
Para mais detalhes, verifique na seção a seguir exemplos de requisição para criar Pix-cob e Pix-cobv: Criar Venda
QRCode e código Copia/Cola
Os QRCode e o código copia/cola são retornados via api através do campo transactions.extra e transactions.payment_number
O QRCode é codificado em base64
Em nossa API, retornamos o QRCode codificado em Base64, portanto é necessário que o converta para imagem caso o intuito seja exibi-lo para leitura em seu e-commerce.
Criar Pix
Abaixo alguns exemplos de requisição e resposta Pix de acordo tipo utilizado.
{
"amount": 10,
"order_id": "BR0000-89100894",
"order_info": "charge description",
"currency": "BRL",
"type": "PAYMENT",
"payments": [
{
"payment_method": "pix-cobv",
"amount": 10,
"pix": {
"due_date": "2025-12-30"
}
}
],
"customer": {
"name": "Leonard Grant",
"email": "[email protected]",
"phone": "5511985270748",
"birth_date": "2000-01-01",
"document_type": "CPF",
"document_number": "62286843023"
},
"billing_address": {
"address_line_1": "Av. Queiroz Filho",
"address_line_2": "Vila Leopoldina",
"street_number": "1560",
"complement": "AP21",
"city": "Sao Paulo",
"state": "SP",
"district": "Vila Leopoldina",
"zip": "05319000",
"country_code": "BRA"
},
"shipping_address": {
"address_line_1": "Av. Queiroz Filho",
"address_line_2": "Vila Leopoldina",
"street_number": "1560",
"complement": "AP21",
"city": "Sao Paulo",
"state": "SP",
"district": "Vila Leopoldina",
"zip": "05319000",
"country_code": "BRA"
}
}{
"amount": 2000,
"order_id": "BR0000-86084116",
"order_info": "charge description",
"currency": "BRL",
"type": "PAYMENT",
"payments": [
{
"payment_method": "pix-cobv",
"amount": 2000,
"pix": {
"fine_type": "amount",
"fine_amount": 1000,
"interest_type": "amount",
"interest_amount": 1000,
"discount_type": "amount",
"discount_amount": 1000,
"due_date": "2025-05-30"
},
"installments": 1,
"create_token": false,
"enable_3ds": false
}
],
"customer": {
"name": "Angel Schinner",
"email": "[email protected]",
"phone": "5511985270748",
"birth_date": "2000-01-01",
"document_type": "CPF",
"document_number": "45917577811"
},
"billing_address": {
"address_line_1": "Av. Queiroz Filho",
"address_line_2": "Vila Leopoldina",
"street_number": "1560",
"complement": "AP21",
"city": "Sao Paulo",
"state": "SP",
"district": "Vila Leopoldina",
"zip": "05319000",
"country_code": "BRA"
},
"shipping_address": {
"country_code": "BRA"
}
}{
"uuid": "38ea6fae-f8c0-4c9c-8e3c-ad4e9aa59f64",
"type": "PAYMENT",
"expiry_date": "2025-03-24T02:59:59Z",
"status": "DUE",
"order_id": "BR0000-91480747",
"order_info": "charge description",
"currency": "BRL",
"original_amount": 10,
"amount": 10,
"paid": 0,
"due": 10,
"refunded": 0,
"attempts": 1,
"max_attempts": 5,
"drop_reason": "",
"surcharge": false,
"client_ip": null,
"soft_descriptor": null,
"customer": {
"uuid": "fee9445f-e049-41fa-a8cc-47f50be4c0df",
"name": "Randall Cole",
"email": "[email protected]",
"birth_date": "2000-01-01",
"phone": "5511985270748",
"mobile_phone": null,
"document_type": "CPF",
"document_number": "622******23",
"created_at": "2025-03-21T12:36:09Z",
"updated_at": "2025-03-21T12:36:09Z"
},
"billing_address": {
"address_line_1": "Av. Queiroz Filho",
"address_line_2": "Vila Leopoldina",
"street_number": "1560",
"complement": "AP21",
"city": "Sao Paulo",
"state": "SP",
"district": "Vila Leopoldina",
"zip": "05319000",
"country_code": "BRA",
"created_at": "2025-03-21T12:36:09Z",
"updated_at": "2025-03-21T12:36:09Z"
},
"shipping_address": {
"address_line_1": "Av. Queiroz Filho",
"address_line_2": "Vila Leopoldina",
"street_number": "1560",
"complement": "AP21",
"city": "Sao Paulo",
"state": "SP",
"district": "Vila Leopoldina",
"zip": "05319000",
"country_code": "BRA",
"created_at": "2025-03-21T12:36:09Z",
"updated_at": "2025-03-21T12:36:09Z"
},
"transactions": [
{
"uuid": "4c3db1d8-0a52-4b7f-9bf2-3ceff245171c",
"charge_uuid": "38ea6fae-f8c0-4c9c-8e3c-ad4e9aa59f64",
"gateway_id": "3daf825e-2056-4f69-8c40-7a8bd6fab42f",
"amount": 10,
"paid_amount": 0,
"status": "WAITING_PAYMENT",
"payment_option": "PIX",
"payment_option_detail": "pix-cobv",
"scheme": "PIX",
"external_id": null,
"transaction_id_reference": null,
"expected_capture_date": "2025-12-30T03:00:00Z",
"payment_at": null,
"captured_at": null,
"auth_num": null,
"auth_response_code": null,
"operation_type": "DEBIT",
"extra": "iVBORw0KGgoAAAANSUhEUgAAAM8AAADPAQAAAAB6+rjyAAAEB0lEQVR4nO2Ywc3jOAyFafigm92AALWhm1pKGnDsBuyWdFMbAtSAddNBMOfRyc4CCyywy8xtxsgl/n78cshH8tHE/3Zd9Af9V3QSPUw5jZ3ZTt7tVGqzRE6NKvdXso/gVs8caY794e2Lv0DRLp4mT0soV3Bb6nO0D/MlcqsZme3Qxovyw3yLHoYW+UoU3JHcSf0rxP2Z8sA0RFdbJ8M19Z+BUiDk65nsPz4/U6lAckU+Gh/sTo/fMiLIf4vt/6OLaMZNwxeiYZD6DDFs98PrUE3jHoh82VLZPW/ytU+B1ejyeZIElcp2MTSFPKfC0akRsztaf8Y+MOOZt4SvOJrVSPIV8wBd0Xj5wi0/G7/P0qEaoUlejWh1Zj4SxN+HxmrECSWJ/9/JO25lDxmH8p0vJWJU4lhjp2DnyGcYj0TPj9hUKBHh4SnPOMi4PYA6qFSPGp9mRJoutCMjDeT0fXqnUoVuIY2gl4HUof+++HK886VCVxg3Hit6mpfC3AlBhm71iBs9fJYmeWeq3kLdDavRRXhmOzBUisRJbXKDopwanZTRHnEHP2FHJw+WzHhEPeKGlutqLEfi2go6G4qUAqtRTXmh/orj6u85m8oa7Cs5NbpMQY52D6FiWEvf2Fpf3p1NhaD5BVKXgdXRPXDzpHIZPcJZqJqDy+qhAUaZv5rcUSMoakDGJbb3dMBYRJ2aLxAjXzQnHIGbBVWJGq+N9ahhpIosl2Cf0U5kn01ckBqhumvi3duFZCyed41X1qMaYU7gIqBzhMUdEX34Ew0dggHYvdsg0cD4wDpurXyauQohti/GYO2LGADEWVzQg/SIIzSPNl62iMggGuPB9Im8CqGhDSwO+cWWbq2Cyp9p0SlViV5BKG2RPeaCDO4vkIfflpAekBajjaAX5eXOlw5VHiVlBlYnY8KuBH2Wg79AMPCYrV6az2rc7Sj+EpsOMRQFGUDzGStMxXHYFIjV6AyEXoH2OFF+JcwymLT8sd8qBBUdMGNpXOEeMRwNZhlssx7hLGxV4u6SGPuJeBPjx3pEGP3wAHApUAINqUBRl9ejy+TbbI9ImaxCiEbr82d+adBJiIMMxCoWRfrSzJCrHl0BmkR47QwNvJ0e5SfrEeY+dknEcxf7DfFjOsDysRphfZ5CuXfJcXvPMpGrU6PT3OP1XhOeEtWMnXoPrEewKJA6hs69qx6RcSKRHuGq9woDq4zIoBVD8B8PoELyfkPyjnaExMlbjoHtw+sRdnPsgKvPC47w4m8hp/dZSiT7GvwtbDwaGuZXkazF75DPJK84kCksRyhSO6SvEPIOlwI/tor+MX36ZL5A8n4D6yR2BPRMZE+G48x6hHy9onjFNfSn7EfwZuXyevTL3879dugHTojCj8FSipgAAAAASUVORK5CYII=",
"payment_number": "00020101021226820014BR.GOV.BCB.PIX2560api.itau/pix/qr/v2/cobv/ba264c7c-adff-4bf4-8bb6-7fe171edf8195204000053039865802BR5912LYRA COLLECT6009SAO PAULO62070503***6304B090",
"payer_info": null,
"expiry_month": null,
"expiry_year": null,
"acquirer_network": null,
"nsu": null,
"tid": "3daf825e20564f698c407a8bd6fab42f",
"token": null,
"create_token": false,
"detailed_status": null,
"currency": "BRL",
"document_type": "CPF",
"document_number": "622******23",
"installments": 0,
"sub_acquirer": 1001,
"auth_3ds": null,
"created_at": "2025-03-21T12:36:11Z",
"updated_at": "2025-03-21T12:36:11Z"
}
],
"created_at": "2025-03-21T12:36:09Z",
"updated_at": "2025-03-21T12:36:09Z"
}