Configuração Inicial via Merchant Portal
Este documento se aplica aos seguintes países:
| Argentina | Chile | México |
|---|
Para outros países, consulte o documento Configuração Inicial via API.
Para processar transações usando o Web Checkout, você deve concluir quatro configurações no módulo Web Checkout do Merchant Portal da Getnet.
Etapa 1: Opções de pagamento e parcelamento
Os estabelecimentos podem configurar opcionalmente sua experiência de checkout habilitando ou desabilitando operações de pagamento específicas. Essas configurações determinam quais meios de pagamento, como Cartões de Crédito e Cartões de Débito, são exibidos durante o processo de checkout.
Essa flexibilidade permite que os estabelecimentos ofereçam as opções de pagamento que melhor atendam às necessidades do negócio e dos clientes.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Os estabelecimentos também podem configurar as opções de parcelamento disponíveis para seus clientes, definindo aspectos-chave da experiência de parcelamento. Essas configurações incluem os planos de parcelamento a serem oferecidos, o número de parcelas disponíveis e a parte responsável por assumir os encargos de juros, que podem ser assumidos pelo portador do cartão ou pelo estabelecimento.
Parcelamento na Argentina
Existem dois principais tipos de opções de parcelamento oferecidos em nível de país, que podem ser processados apenas com cartões nacionais ou domésticos:
- Planos do emissor: Planos de parcelamento base oferecidos pelo Emissor/Bancos.
- Planos governamentais (Cuota Simple / Plan Ahora): Opção oferecida pelo governo argentino, geralmente com taxas de juros menores que as do plano do emissor.
Parcelamento no Chile
Existem dois principais tipos de opções de parcelamento oferecidos em nível de país:
- Planos do emissor: Planos de parcelamento base oferecidos pelo Emissor/Bancos, com opções que variam de 2 a 48 parcelas. O estabelecimento recebe a liquidação da transação uma única vez, e o portador do cartão paga o valor total e as taxas correspondentes aplicadas posteriormente.
- Parcelamento do estabelecimento (Cuota Comercio): Plano sem juros oferecido pelo estabelecimento, com opções que variam de 2 a 12 parcelas. O estabelecimento recebe a liquidação da transação em múltiplas vezes, de acordo com o plano selecionado.
Parcelamento no México
Existe um principal tipo de opção de parcelamento oferecido em nível de país:
- MSI (Meses sin interés): Planos de parcelamento base oferecidos pela PROSA, nos quais o banco pessoal do cliente é responsável por cobrar os pagamentos, enquanto o estabelecimento recebe uma liquidação única que inclui as taxas deduzidas.
Etapa 2: Personalizar o checkout
Como recurso opcional, os estabelecimentos podem personalizar a aparência da interface do Web Checkout exibida aos clientes. Isso permite alinhar a experiência de checkout à identidade visual do e-commerce do estabelecimento. As opções de personalização disponíveis incluem cor da marca, cor de destaque e fonte.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Etapa 3: URLs de redirecionamento
As URLs de redirecionamento são usadas para enviar os clientes a endpoints predefinidos quando uma transação é aprovada ou recusada durante o processo de checkout.
Você deve informar duas URLs:
- Success: para transações aprovadas.
- Error: para transações recusadas.
Ambas as URLs são obrigatórias para concluir a integração com sucesso.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Etapa 4: Notificações via Webhook
Um webhook é um mecanismo leve de comunicação orientado a eventos que permite que uma aplicação notifique automaticamente outra via HTTP. Essa abordagem elimina a necessidade de consultas contínuas (polling) e oferece suporte à troca de dados quase em tempo real e à integração entre sistemas.
Para implementar um webhook, o cliente fornece uma URL de callback exclusiva à API do servidor e especifica os eventos que deseja receber. Na etapa final da configuração do checkout no Merchant Portal, você deve fornecer uma URL de callback totalmente qualificada (endpoint do servidor).
Além disso, é necessário informar um usuário e uma senha. Essas credenciais são incluídas como um valor codificado em base64 no header Authorization de cada notificação enviada pela Getnet, e devem ser usadas pelo seu servidor para validar que a notificação veio da Getnet.
Depois de configurar o webhook, a Getnet envia automaticamente notificações para a URL especificada sempre que ocorre um evento de transação. Cada notificação inclui os dados originais do pagamento, além de um objeto result, aninhado dentro do objeto payment de nível superior, que contém o status do pagamento e os detalhes de autorização.
<doc-tabs active="1">
<doc-tab label="Argentina"></doc-tab>
<doc-tab label="Chile"></doc-tab>
<doc-tab label="Mexico"></doc-tab>
</doc-tabs>Mesmo que você não precise enviar uma confirmação formal, seu sistema deve retornar uma resposta HTTP 200 de sucesso. Caso seja retornada uma resposta HTTP 500 de erro, ou nenhuma resposta seja recebida, a notificação de webhook será reenviada em até 5 tentativas, em intervalos crescentes.
Após essas 5 tentativas iniciais, a notificação é reenviada a cada 1 hora, por até 72 horas. Depois desse período, a Getnet interrompe novas tentativas de notificação.
Embora não seja necessária uma confirmação formal, seu sistema deve retornar uma resposta HTTP 200 (OK) ao receber uma notificação de webhook. Se for retornada uma resposta HTTP 500 (ERROR), ou se nenhuma resposta for recebida, a notificação será reenviada.
A Getnet reenvia a notificação de webhook até cinco vezes, em intervalos progressivamente crescentes. Se a notificação ainda não for entregue com sucesso após essas tentativas iniciais, as novas tentativas continuam uma vez por hora, por até 72 horas. Após esse período, a Getnet interrompe qualquer nova tentativa de notificação.
Exemplo de payload de transação AUTHORIZED:
{
"payment_intent_id": "1f9f47ed-65cc-4fbf-a407-0f17df9a2e2c",
"checkout_id": "5ab15d1e-ea8b-4560-84d2-fb3d02179537",
"order_id": "YOUR_ORDER_ID",
"mode": "instant",
"seller": {
"id": "716d899e-9091-4577-a12f-8a77ec4d1e0b",
"trade_name": "GetNet Shop",
"merchant_document": "00000000000",
"settings": {
"notification_url_configured": true
}
},
"customer": {
"customer_id": "c129d793-d204-4610-8819-b8fb720a8552",
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"email": "[email protected]",
"document_type": "dni",
"document_number": "1111111111111",
"checked_email": false,
"billing_address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"shipping": {
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"payment": {
"method": "credit",
"amount": 14100,
"currency": "ARS",
"installment": {
"quote_id": "f054ce63-0475-406f-8eca-25aea5dae6a8",
"schema": "plan_name",
"type": "with_interest",
"number": 6
},
"payment_method": {
"token_id": "e327bae6-286e-4920-addb-5f4b10315b4e"
},
"result": {
"payment_id": "3a76acae-d9c0-421c-91e0-cf5ce8aca098",
"status": "Authorized",
"authorization_code": "999999",
"transaction_datetime": "2024-01-01T12:00:00.000Z"
}
},
"pickup_store": false,
"product": [
{
"product_type": "cash_carry",
"title": "Look Fashion Leather Boot",
"value": 5300,
"quantity": 1
},
{
"product_type": "cash_carry",
"title": "Look Fashion Blazer",
"value": 8800,
"quantity": 1
}
],
"frontend": {
"link": "https://www.globalgetnet.com/",
"time_page": 39,
"sales_channel": "WEB",
"application_version": "0.0.0",
"card_pasted": true,
"ip": "000.000.00.00",
"timezone": "America/Sao_Paulo",
"locale": "en-US"
},
"created_at": "2024-01-01T12:00:00.000Z",
"updated_at": "2024-01-01T12:00:00.000Z"
}Exemplo de payload de transação DENIED:
{
"payment_intent_id": "1f9f47ed-65cc-4fbf-a407-0f17df9a2e2c",
"checkout_id": "5ab15d1e-ea8b-4560-84d2-fb3d02179537",
"order_id": "YOUR_ORDER_ID",
"mode": "instant",
"seller": {
"id": "716d899e-9091-4577-a12f-8a77ec4d1e0b",
"trade_name": "Getnet Shop",
"merchant_document": "00000000000",
"settings": {
"notification_url_configured": true
}
},
"customer": {
"customer_id": "c129d793-d204-4610-8819-b8fb720a8552",
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"email": "[email protected]",
"document_type": "dni",
"document_number": "1111111111111",
"checked_email": false,
"billing_address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"shipping": {
"first_name": "John",
"last_name": "Doe",
"name": "John Doe",
"address": {
"street": "South Rockledge St",
"number": "00",
"complement": "Rockville",
"country": "AR",
"postal_code": "00000000"
}
},
"payment": {
"method": "credit",
"amount": 14100,
"currency": "ARS",
"installment": {
"quote_id": "f054ce63-0475-406f-8eca-25aea5dae6a8",
"schema": "plan_name",
"type": "with_interest",
"number": 6
},
"payment_method": {
"token_id": "e327bae6-286e-4920-addb-5f4b10315b4e"
},
"result": {
"payment_id": "3a76acae-d9c0-421c-91e0-cf5ce8aca098",
"status": "Denied",
"return_message": "Card not accepted for this operation",
"transaction_datetime": "2024-01-01T12:00:00.000Z"
}
},
"pickup_store": false,
"product": [
{
"product_type": "cash_carry",
"title": "Look Fashion Leather Boot",
"value": 5300,
"quantity": 1
},
{
"product_type": "cash_carry",
"title": "Look Fashion Blazer",
"value": 8800,
"quantity": 1
}
],
"frontend": {
"link": "https://www.globalgetnet.com/",
"time_page": 39,
"sales_channel": "WEB",
"application_version": "0.0.0",
"card_pasted": true,
"ip": "000.000.00.00",
"timezone": "America/Sao_Paulo",
"locale": "en-US"
},
"created_at": "2024-01-01T12:00:00.000Z",
"updated_at": "2024-01-01T12:00:00.000Z"
}Para mais detalhes, consulte a API reference