Tokenização de bandeiras Pagar.me
Tal funcionalidade está sendo liberada aos poucos para a nossa base!
A API Pagar.me oferece para os clientes uma forma automatizada e transparente de Tokenização nas bandeiras.
Para utilizar a tokenização Pagar.me não é necessária nenhuma modificação na integração.
Essa página descreve o fluxo e as funcionalidades adicionais sobre a Tokenização de bandeiras Pagar.me.
Um pagamento com a Tokenização Pagar.me segue o seguinte fluxo:
TOKENIZAÇÃO PAGAR.ME - Transacional com card_id (cartão já tokenizado)
O Pagar.me recebe os dados do cartão enviado pela loja e envia os mesmos para a bandeira tokenizar. A bandeira fornece o Network Token (Token de bandeira) que é referenciado ao cartão.
O Pagar.me então envia os dados do Network Token para a adquirente, que em seguida faz a comunicação com a bandeira do cartão utilizado e com o banco emissor.
Para utilizar a Tokenização Pagar.me não é necessária nenhuma modificação na integração. Ou seja, a integração já funcional com os Endpoints transacionais da API v5 são compatíveis com a Tokenização Pagar.me
Os Endpoints que operam com a Tokenização Pagar.me são:
/orders
/charges
/subscriptions
/cards
Sendo assim, as criações de cartões realizadas através dos Endpoints listados acima, sempre realizarão o fluxo de tokenização de bandeiras de forma automática.
Nos Endpoints transacionais (/order, /charges e /subscriptions (nos casos de assinaturas pré-pagas), com o intuito de não aumentar o tempo transacional, a tokenização junto a bandeira, só irá ocorrer após a transação. Isso quer dizer que, para você garantir que a transação será realizada com token de bandeira, é necessário que você primeiro crie o cartão em /cards e depois transacionar.
Nestes Endpoints a partir do campo payment_type é possível identificar se a transação ocorreu via Token ou PAN.
Adicionamos também o campo network_token , no qual exibimos as informações:
token_unique_reference, responsável por ser o referenciador único do Network Token, e status do Network Token.
Conforme os exemplos de Response a seguir, é possível notar tais informações:
{
"id": "or_NlprDwmPuPUwJgMd",
"code": "ZLM0SE3H4W",
"amount": 2990,
"currency": "BRL",
"closed": true,
"items": [
{
"id": "oi_RmYajm0iYBCvX7ok",
"type": "product",
"description": "Chaveiro do Tesseract",
"amount": 2990,
"quantity": 1,
"status": "active",
"created_at": "2023-02-16T12:22:13Z",
"updated_at": "2023-02-16T12:22:13Z"
}
],
"customer": {
"id": "cus_xBWrv8ltDEc7v8KV",
"name": "Tony Stark",
"email": "[email protected]",
"delinquent": false,
"created_at": "2023-02-16T12:22:13Z",
"updated_at": "2023-02-16T12:22:13Z",
"phones": {}
},
"status": "pending",
"created_at": "2023-02-16T12:22:13Z",
"updated_at": "2023-02-16T12:22:17Z",
"closed_at": "2023-02-16T12:22:13Z",
"charges": [
{
"id": "ch_RvXONMxTW5IKb2w6",
"code": "ZLM0SE3H4W",
"amount": 2990,
"status": "pending",
"currency": "BRL",
"payment_method": "credit_card",
"created_at": "2023-02-16T12:22:16Z",
"updated_at": "2023-02-16T12:22:17Z",
"customer": {
"id": "cus_xBWrv8ltDEc7v8KV",
"name": "Tony Stark",
"email": "[email protected]",
"delinquent": false,
"created_at": "2023-02-16T12:22:13Z",
"updated_at": "2023-02-16T12:22:13Z",
"phones": {}
},
"last_transaction": {
"operation_key": "688638355",
"id": "tran_Xv0gjWIdqcxN4Azw",
"transaction_type": "credit_card",
"gateway_id": "b4693993-4bed-4b99-9785-c71c22008fe9",
"amount": 2990,
"status": "authorized_pending_capture",
"success": true,
"installments": 1,
"installment_type": "merchant",
"statement_descriptor": "AVENGERS",
"acquirer_name": "simulator",
"acquirer_tid": "541434833",
"acquirer_nsu": "63415",
"acquirer_auth_code": "642",
"acquirer_message": "Transação autorizada com sucesso",
"acquirer_return_code": "00",
"entry_mode": "ecommerce",
"operation_type": "auth_only",
"card": {
"id": "card_Z4BjP4vSOuZZj50R",
"first_six_digits": "400000",
"last_four_digits": "0010",
"brand": "Visa",
"holder_name": "Homelander",
"exp_month": 12,
"exp_year": 2025,
"status": "active",
"type": "credit",
"created_at": "2023-02-16T12:22:14Z",
"updated_at": "2023-02-16T12:22:14Z",
"billing_address": {
"zip_code": "90265",
"city": "Malibu",
"state": "CA",
"country": "US",
"line_1": "10880, Malibu Point, Malibu Central"
},
"network_token": {
"token_unique_reference": "a82266bb-835c-45b1-95e3-7389321aaea6",
"status": "active"
}
},
"payment_type": "Token",
"created_at": "2023-02-16T12:22:16Z",
"updated_at": "2023-02-16T12:22:16Z",
"gateway_response": {
"code": "200",
"errors": []
},
"antifraud_response": {},
"metadata": {}
}
}
]
}
{
"id": "ch_mkwMWxfA2h4k8vJz",
"code": "YMEOS44U2W",
"amount": 2990,
"paid_amount": 2990,
"status": "paid",
"currency": "BRL",
"payment_method": "credit_card",
"paid_at": "2023-02-16T12:28:07Z",
"created_at": "2023-02-16T12:28:07Z",
"updated_at": "2023-02-16T12:28:07Z",
"customer": {
"id": "cus_0RypzyawTwc7zjbL",
"name": "Tony Stark",
"email": "[email protected]",
"document": "12389987613",
"document_type": "cpf",
"type": "individual",
"delinquent": false,
"address": {
"id": "addr_YQbJOAOUrIQawZgn",
"line_1": "375, Av. General Justo, Centro",
"line_2": "8º andar",
"zip_code": "20021130",
"city": "Rio de Janeiro",
"state": "RJ",
"country": "BR",
"status": "active",
"created_at": "2023-02-16T12:28:05Z",
"updated_at": "2023-02-16T12:28:05Z"
},
"created_at": "2023-02-16T12:28:04Z",
"updated_at": "2023-02-16T12:28:04Z",
"phones": {}
},
"last_transaction": {
"operation_key": "740084069",
"id": "tran_rmV6z8XIBZHGQwXp",
"transaction_type": "credit_card",
"gateway_id": "ac8f4cf8-6dbd-4784-9cb4-5d1c8a807e55",
"amount": 2990,
"status": "captured",
"success": true,
"installments": 1,
"installment_type": "merchant",
"statement_descriptor": "AVENGERS",
"acquirer_name": "simulator",
"acquirer_tid": "764647086",
"acquirer_nsu": "44967",
"acquirer_auth_code": "213",
"acquirer_message": "Transação capturada com sucesso",
"acquirer_return_code": "00",
"entry_mode": "ecommerce",
"operation_type": "auth_and_capture",
"card": {
"id": "card_zQ7gy75HPS82GMYV",
"first_six_digits": "400000",
"last_four_digits": "0010",
"brand": "Visa",
"holder_name": "Homelander",
"exp_month": 12,
"exp_year": 2025,
"status": "active",
"type": "credit",
"created_at": "2023-02-16T12:28:05Z",
"updated_at": "2023-02-16T12:28:05Z",
"network_token": {
"token_unique_reference": "a82266bb-835c-45b1-95e3-7389321aaea6",
"status": "active"
}
},
"payment_type": "Token",
"created_at": "2023-02-16T12:28:07Z",
"updated_at": "2023-02-16T12:28:07Z",
"gateway_response": {
"code": "200",
"errors": []
},
"antifraud_response": {},
"metadata": {}
}
}
{
"id": "sub_lvebnYoF3F9qdJ2V",
"code": "OKLRB94UG8",
"start_at": "2023-02-16T00:00:00Z",
"interval": "month",
"interval_count": 3,
"billing_type": "prepaid",
"current_cycle": {
"id": "cycle_wOQ6XNQcjhBYjKe7",
"start_at": "2023-02-16T00:00:00Z",
"end_at": "2023-05-15T23:59:59Z",
"billing_at": "2023-02-16T00:00:00Z",
"status": "billed",
"cycle": 1
},
"next_billing_at": "2023-05-16T00:00:00Z",
"payment_method": "credit_card",
"currency": "BRL",
"installments": 1,
"minimum_price": 10000,
"status": "active",
"boleto_due_days": 5,
"created_at": "2023-02-16T12:30:04Z",
"updated_at": "2023-02-16T12:30:04Z",
"customer": {
"id": "cus_XNx0Kz8fqrhNJ5aR",
"name": "Tony Stark",
"email": "[email protected]",
"code": "MY_CUSTOMER_001",
"document": "93095135270",
"document_type": "cpf",
"type": "individual",
"gender": "male",
"delinquent": false,
"address": {
"id": "addr_dVjKmkeTjzUr5Q6n",
"line_1": "375, Av. General Justo, Centro",
"line_2": "8º andar",
"zip_code": "20021130",
"city": "Rio de Janeiro",
"state": "RJ",
"country": "BR",
"status": "active",
"created_at": "2023-02-16T12:29:45Z",
"updated_at": "2023-02-16T12:29:45Z"
},
"created_at": "2023-02-16T12:29:45Z",
"updated_at": "2023-02-16T12:29:45Z",
"birthdate": "1984-05-03T00:00:00Z",
"phones": {
"home_phone": {
"country_code": "55",
"number": "000000000",
"area_code": "21"
},
"mobile_phone": {
"country_code": "55",
"number": "000000000",
"area_code": "21"
}
},
"metadata": {
"company": "Avengers"
}
},
"card": {
"id": "card_yArd6eZsWTjV0eZk",
"first_six_digits": "400000",
"last_four_digits": "0010",
"brand": "Visa",
"holder_name": "Ned Stark",
"exp_month": 12,
"exp_year": 2025,
"status": "active",
"type": "credit",
"created_at": "2023-02-16T12:30:03Z",
"updated_at": "2023-02-16T12:30:03Z",
"billing_address": {
"zip_code": "20021130",
"city": "Rio de Janeiro",
"state": "RJ",
"country": "BR",
"line_1": "375, Av. General Justo, Centro",
"line_2": "8º andar"
},
"network_token": {
"token_unique_reference": "a82266bb-835c-45b1-95e3-7389321aaea6",
"status": "active"
}
},
"items": [
{
"id": "si_2rY3j9JTYWUlbZ80",
"description": "Musculação",
"quantity": 1,
"status": "active",
"created_at": "2023-02-16T12:30:04Z",
"updated_at": "2023-02-16T12:30:04Z",
"pricing_scheme": {
"price": 18990,
"scheme_type": "unit"
}
},
{
"id": "si_a81zPKQCnH29wq0x",
"description": "Matrícula",
"cycles": 1,
"quantity": 1,
"status": "active",
"created_at": "2023-02-16T12:30:04Z",
"updated_at": "2023-02-16T12:30:04Z",
"pricing_scheme": {
"price": 5990,
"scheme_type": "unit"
}
}
],
"boleto": {}
}
{
"id": "card_yArd6eZsWTjV0eZk",
"first_six_digits": "400000",
"last_four_digits": "0010",
"brand": "Visa",
"holder_name": "Tony Stark",
"holder_document": "12345678909",
"exp_month": 12,
"exp_year": 2025,
"status": "active",
"type": "credit",
"created_at": "2023-02-16T12:30:03Z",
"updated_at": "2023-02-16T12:32:23Z",
"billing_address": {
"zip_code": "220000111",
"city": "Rio de Janeiro",
"state": "RJ",
"country": "BR",
"line_1": "375, Av. General Osorio, Centro",
"line_2": "7º Andar"
},
"network_token": {
"token_unique_reference": "a82266bb-835c-45b1-95e3-7389321aaea6",
"status": "active"
},
"customer": {
"id": "cus_XNx0Kz8fqrhNJ5aR",
"name": "Tony Stark",
"email": "[email protected]",
"code": "MY_CUSTOMER_001",
"document": "93095135270",
"document_type": "cpf",
"type": "individual",
"gender": "male",
"delinquent": false,
"created_at": "2023-02-16T12:29:45Z",
"updated_at": "2023-02-16T12:29:45Z",
"birthdate": "1984-05-03T00:00:00Z",
"phones": {
"home_phone": {
"country_code": "55",
"number": "000000000",
"area_code": "21"
},
"mobile_phone": {
"country_code": "55",
"number": "000000000",
"area_code": "21"
}
},
"metadata": {
"company": "Avengers"
}
}
}
Adquirentes:
A Pagar.me está integrada com as principais adquirentes do mercado. É possível transacionar utilizando o Network Token nas seguintes adquirentes:
Stone
Cielo
Adquirentes não integradas
Demais adquirentes ainda não estão habilitadas para transacionar utilizando o Network Token.
A API Pagar.me consegue identificar este cenário e segue operando plenamente pelo fluxo primitivo (utilizando os dados do cartão, como o PAN).
Bandeiras:
A Pagar.me está integrada com as principais bandeiras do mercado. É possível provisionar o Network Token com a Tokenização Pagar.me nas seguintes bandeiras:
Visa
Mastercard
Bandeiras não integradas
Demais bandeiras ainda não estão habilitadas para provisionar o Network Token pela Tokenização Pagar.me.
A API Pagar.me neste cenário, segue operando plenamente pelo fluxo primitivo (utilizando os dados do cartão aberto).
Cartões não tokenizaveis
Mesmo em bandeiras integradas, nem todos os cartões estão aptos a tokenizar.
Por se tratar de uma funcionalidade que tem integração com as bandeiras e respectivos emissores, nem todos os cartões estão aptos a tokenizar. Em tais casos, o fluxo transacional segue utilizando os dados do cartão aberto.
A Tokenização Pagar.me tem a redundância nesses casos, e segue a transação normalmente.
No seu Dashboard:
A transação continuará apresentando as mesmas características de uma transação com cartão de crédito.
Perguntas frequentes
Qual a diferença entre Token de bandeira (Network Token) vs Card_id/Token id?
A Tokenização de Bandeira é realizada junto as bandeiras dos cartões, e consiste no processo de substituição dos dados sensíveis do cartão do portador por um Network Token, adicionando maior segurança, conversão e demais benefícios.
O Card_id/Token id, é utilizado como um identificador, para que você cliente possa referenciar os cartões na Wallet da Pagar.me, ou seja, armazenar os cartões dos seus clientes para futuras compras.
A Tokenização Pagar.me não afeta o uso do Card_id/Token id, assim como o contrário também é verdadeiro.
Como eu posso habilitar a Tokenização de Bandeira?
Por ser um produto inédito no mercado estamos liberando a feature gradualmente para nossos clientes, não sendo possível ainda habilitar a Tokenização via Dashboard. Para mais informações, não deixe de entrar em contato com nosso time de atendimento.
Qual o aumento de conversão esperado?
Por se tratar de uma funcionalidade que tem interface com a bandeira do cartão, e promove um aumento de segurança durante o fluxo transacional, é esperado que em transações utilizando o Network Token tenham um aumento na taxa de aprovações. A responsabilidade por esse aumento é da bandeira.
Os cartões não tokenizados já salvos, passarão pelo fluxo de tokenização nas bandeiras?
Os cartões só passarão pelo fluxo de tokenização ao transacionarem novamente.
Quais são as opções de implementação de Network Token?
Você pode escolher duas opções:
Tokenização de bandeiras Pagar.me: o Pagar.me é responsável por todo o fluxo de tokenização e não é necessário nenhuma mudança adicional na sua integração.
Tokenização Pass Through: Requer mudança na integração com o intuito de permitir o envio dos dados de Network Token para transacionar. Saiba mais aqui.