Informando os dados essenciais para efetivação de pagamento, este recurso permite a criação de um pedido com cobrança de pagamento com token de bandeira previamente gerado.
A Tokenização de Bandeira é o processo de substituição dos dados sensíveis do cartão do portador por tokens de pagamento gerados pelas bandeiras.
IMPORTANTE
O pedido com token de bandeira é diferente da tokenização PagSeguro.
Com a Tokenização PagSeguro o cartão de crédito fica armazenado para compras futuras e na resposta da requisição você terá o token do cartão em
payment_method.card.id.Com a pedido com token de bandeira os dados utilizados para a criação de uma transação são os do próprio Token de Bandeira, fornecido pelas bandeiras e que possui características similiares a um cartão de crédito ou débito.
1. Primeiro passo: Gerar o token de bandeira
Contrate alguma solução para a geração de tokens de bandeira diretamente com as bandeiras.
IMPORTANTE
A cobrança com tokens das bandeiras VISA e MASTER tem a mesma estrutura e solicitam os mesmos dados, contudo a cobrança com token da bandeira ELO solicita dados diferentes.
O sucesso de uma tokenização resulta em dados do token e, em alguns casos, dados adicionais de tokenização, que devem ser informados na criação de um Pedido com token de bandeira, como por exemplo:
Mastercard e Visa
cryptogram- Criptograma gerado pela bandeirarequestor_id- Identificador de quem gerou o token de bandeira (Token Requestor)wallet- Tipo de carteira que armazenou o token de bandeiraecommerce_domain- Identificador do domínio de origem da transaçãoassurance_level- Conteúdo que indica o nível de confiança do token de bandeira
Elo
Quando um token é gerado pela bandeira Elo através de uma carteira digital, é necessário informar dados de autenticação In-App:
cavv- Identificador único gerado em cenário de sucesso de autenticaçãoeci- E-Commerce Indicator.
2. Segundo passo: Criar o pedido
Crie um pedido informando os dados do token de bandeira e, de acordo com a bandeira, dados adicionais de tokenização no objeto token_data ou dados de autenticação no objeto authentication_method, conforme os exemplos a seguir:
Exemplos para as bandeiras VISA e MASTERCARD (Crédito e Débito):
curl --location --request POST 'https://sandbox.api.pagseguro.com/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
"reference_id": "ex-00001",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"country": "55",
"area": "11",
"number": "999999999",
"type": "MOBILE"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"notification_urls": [
"https://meusite.com/notificacoes"
],
"charges": [
{
"reference_id": "referencia da cobranca",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL"
},
"payment_method":{
"type":"CREDIT_CARD",
"installments":1,
"capture":true,
"card":{
"network_token":"5454555555555555",
"exp_month":"12",
"exp_year":"2026",
"security_code":"123",
"holder":{
"name":"Jose da Silva"
},
"token_data":{
"requestor_id":"12345678901",
"wallet":"APPLE_PAY",
"cryptogram":"BNQ1qJkmBYWiAAuzyDDhAoABFA==",
"ecommerce_domain":"br.com.pagseguro",
"assurance_level":88
}
}
}
}
]
}'
{
"id": "ORDE_A0C334AD-244E-4175-A04F-A69C812FFFD0",
"reference_id": "ex-00001",
"created_at": "2023-02-08T18:29:03.344-03:00",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "999999999"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"charges": [
{
"id": "CHAR_84E0D7ED-A84E-4098-A289-6A7E4E09DAB2",
"reference_id": "referencia da cobranca",
"status": "PAID",
"created_at": "2023-02-08T18:29:03.835-03:00",
"paid_at": "2023-02-08T18:29:05.000-03:00",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL",
"summary": {
"total": 500,
"paid": 500,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "032416400102"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"brand": "mastercard",
"first_digits": "545455",
"last_digits": "5555",
"exp_month": "12",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva"
},
"token_data": {
"requestor_id": "12345678901",
"wallet": "APPLE_PAY",
"ecommerce_domain": "br.com.pagseguro",
"assurance_level": 88
}
},
"soft_descriptor": "IntegracaoPagsegu"
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_84E0D7ED-A84E-4098-A289-6A7E4E09DAB2",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_84E0D7ED-A84E-4098-A289-6A7E4E09DAB2/cancel",
"media": "application/json",
"type": "POST"
}
]
}
],
"notification_urls": [
"https://meusite.com/notificacoes"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_A0C334AD-244E-4175-A04F-A69C812FFFD0",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_A0C334AD-244E-4175-A04F-A69C812FFFD0/pay",
"media": "application/json",
"type": "POST"
}
]
}
curl --location --request POST 'https://sandbox.api.pagseguro.com/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
"reference_id": "ex-00001",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"country": "55",
"area": "11",
"number": "999999999",
"type": "MOBILE"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"notification_urls": [
"https://meusite.com/notificacoes"
],
"charges": [
{
"reference_id": "referencia da cobranca",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL"
},
"payment_method":{
"type":"DEBIT_CARD",
"card":{
"network_token":"4111111111111111",
"exp_month":"03",
"exp_year":"2026",
"security_code":"123",
"holder":{
"name":"Jose da Silva"
},
"token_data":{
"requestor_id":"12345678901",
"wallet":"APPLE_PAY",
"cryptogram":"BNQ1qJkmBYWiAAuzyDDhAoABFA==",
"ecommerce_domain":"br.com.pagseguro",
"assurance_level":99
}
},
"authentication_method":{
"type":"THREEDS",
"cavv":"BwABBylVaQAAAAFwllVpAAAAAAA=",
"xid":"BwABBylVaQAAAAFwllVpAAAAAAA=",
"eci":"01",
"version":"2.1.0",
"dstrans_id":"DIR_SERVER_TID"
}
}
}
]
}'
{
"id": "ORDE_4D5BF33A-2D5C-472A-9191-35AC4EAAD082",
"reference_id": "ex-00001",
"created_at": "2023-02-08T18:30:32.028-03:00",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "999999999"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"charges": [
{
"id": "CHAR_783542CE-D2D4-45DD-B965-191CEB353026",
"reference_id": "referencia da cobranca",
"status": "PAID",
"created_at": "2023-02-08T18:30:32.519-03:00",
"paid_at": "2023-02-08T18:30:34.000-03:00",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL",
"summary": {
"total": 500,
"paid": 500,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "032416400102"
},
"payment_method": {
"type": "DEBIT_CARD",
"card": {
"brand": "visa",
"first_digits": "411111",
"last_digits": "1111",
"exp_month": "3",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva"
},
"token_data": {
"requestor_id": "12345678901",
"wallet": "APPLE_PAY",
"ecommerce_domain": "br.com.pagseguro",
"assurance_level": 99
}
},
"authentication_method": {
"type": "THREEDS",
"eci": "01",
"cavv": "BwABBylVaQAAAAFwllVpAAAAAAA=",
"xid": "BwABBylVaQAAAAFwllVpAAAAAAA=",
"version": "2.1.0",
"dstrans_id": "DIR_SERVER_TID",
"status": "AUTHENTICATED"
},
"soft_descriptor": "IntegracaoPagsegu"
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_783542CE-D2D4-45DD-B965-191CEB353026",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_783542CE-D2D4-45DD-B965-191CEB353026/cancel",
"media": "application/json",
"type": "POST"
}
]
}
],
"notification_urls": [
"https://meusite.com/notificacoes"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_4D5BF33A-2D5C-472A-9191-35AC4EAAD082",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_4D5BF33A-2D5C-472A-9191-35AC4EAAD082/pay",
"media": "application/json",
"type": "POST"
}
]
}
Exemplos para bandeira ELO (Crédito e Débito):
curl --location --request POST 'https://sandbox.api.pagseguro.com/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
"reference_id": "ex-00001",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"country": "55",
"area": "11",
"number": "999999999",
"type": "MOBILE"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"notification_urls": [
"https://meusite.com/notificacoes"
],
"charges": [
{
"reference_id": "referencia da cobranca",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL"
},
"payment_method":{
"type":"CREDIT_CARD",
"installments":1,
"capture":true,
"soft_descriptor":"My Store",
"card":{
"network_token":"6550000000000001",
"exp_month":"12",
"exp_year":"2026",
"security_code":"123",
"holder":{
"name":"Jose da Silva"
}
},
"authentication_method":{
"type":"INAPP",
"cavv":"BwABBylVaQAAAAFwllVpAAAAAAA=",
"eci":"04"
}
}
}
]
}'
{
"id": "ORDE_6B853515-385F-4463-96F5-3CBFFD1C4309",
"reference_id": "ex-00001",
"created_at": "2023-02-08T18:34:08.746-03:00",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "999999999"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"charges": [
{
"id": "CHAR_A76DCB77-B856-4726-9B6A-F1FA012E81E3",
"reference_id": "referencia da cobranca",
"status": "PAID",
"created_at": "2023-02-08T18:34:09.220-03:00",
"paid_at": "2023-02-08T18:34:10.000-03:00",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL",
"summary": {
"total": 500,
"paid": 500,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "032416400102"
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"brand": "elo",
"first_digits": "655000",
"last_digits": "0001",
"exp_month": "12",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva"
}
},
"authentication_method": {
"type": "INAPP",
"eci": "04",
"cavv": "BwABBylVaQAAAAFwllVpAAAAAAA="
},
"soft_descriptor": "MyStore"
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_A76DCB77-B856-4726-9B6A-F1FA012E81E3",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_A76DCB77-B856-4726-9B6A-F1FA012E81E3/cancel",
"media": "application/json",
"type": "POST"
}
]
}
],
"notification_urls": [
"https://meusite.com/notificacoes"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_6B853515-385F-4463-96F5-3CBFFD1C4309",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_6B853515-385F-4463-96F5-3CBFFD1C4309/pay",
"media": "application/json",
"type": "POST"
}
]
}
curl --location --request POST 'https://sandbox.api.pagseguro.com/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data-raw '{
"reference_id": "ex-00001",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"country": "55",
"area": "11",
"number": "999999999",
"type": "MOBILE"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"notification_urls": [
"https://meusite.com/notificacoes"
],
"charges": [
{
"reference_id": "referencia da cobranca",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL"
},
"payment_method":{
"type":"DEBIT_CARD",
"card":{
"network_token":"6550000000000001",
"exp_month":"12",
"exp_year":"2026",
"security_code":"123",
"holder":{
"name":"Jose da Silva"
}
},
"authentication_method":{
"type":"INAPP",
"cavv":"BwABBylVaQAAAAFwllVpAAAAAAA=",
"eci":"04"
}
}
}
]
}'
{
"id": "ORDE_DD89BC61-1D4F-4B35-9A1F-3B88C0481B27",
"reference_id": "ex-00001",
"created_at": "2023-02-08T18:35:13.398-03:00",
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "999999999"
}
]
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"charges": [
{
"id": "CHAR_C40A96D0-0FD1-4248-929F-A38C94ED6458",
"reference_id": "referencia da cobranca",
"status": "PAID",
"created_at": "2023-02-08T18:35:13.896-03:00",
"paid_at": "2023-02-08T18:35:15.000-03:00",
"description": "descricao da cobranca",
"amount": {
"value": 500,
"currency": "BRL",
"summary": {
"total": 500,
"paid": 500,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "032416400102"
},
"payment_method": {
"type": "DEBIT_CARD",
"card": {
"brand": "elo",
"first_digits": "655000",
"last_digits": "0001",
"exp_month": "12",
"exp_year": "2026",
"holder": {
"name": "Jose da Silva"
}
},
"authentication_method": {
"type": "INAPP",
"eci": "04",
"cavv": "BwABBylVaQAAAAFwllVpAAAAAAA="
},
"soft_descriptor": "IntegracaoPagsegu"
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_C40A96D0-0FD1-4248-929F-A38C94ED6458",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_C40A96D0-0FD1-4248-929F-A38C94ED6458/cancel",
"media": "application/json",
"type": "POST"
}
]
}
],
"notification_urls": [
"https://meusite.com/notificacoes"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_DD89BC61-1D4F-4B35-9A1F-3B88C0481B27",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_DD89BC61-1D4F-4B35-9A1F-3B88C0481B27/pay",
"media": "application/json",
"type": "POST"
}
]
}