Configure Web Checkout in the Merchant Portal

This document applies to the following countries:

ArgentinaChileMexico
information icon

For other countries, see the Initial Configuration via API page.

To process transactions with Web Checkout, complete the four configuration steps in the Web Checkout module of Getnet's Merchant Portal.

Step 1: Configure payment and installment options

You can optionally configure your checkout experience by enabling or disabling specific payment operations. These settings determine which payment methods, such as credit cards and debit cards, appear during checkout.

This flexibility lets you offer the payment options that best meet your business and customer needs.

You can also configure the installment options available to your customers and define key aspects of the installment experience. These configurations include the installment plans to offer, the number of installments available, and the party responsible for absorbing interest fees. Either the cardholder or the merchant can assume these fees.

Argentina installments

Argentina offers two main types of installment options at country level. You can process them only with national or domestic cards:

  • Issuer plans: Base installment plans offered by the issuers/banks.
  • Government plans (Cuota Simple / Plan Ahora): Option offered by the Argentinian government, usually at lower interest fees than the issuer plans.

Chile installments

Chile offers two main types of installment options at country level:

  • Issuer plans: Base installment plans offered by the issuers/banks, with options ranging from 2 to 48. You settle the transaction only once. The cardholder pays the total amount and any corresponding fees applied afterwards.
  • Merchant installments (Cuota Comercio): No-fee plan that you offer as the merchant, with options ranging from 2 to 12. You settle the transaction multiple times, depending on the selected plan.

Mexico installments

Mexico offers one main type of installment option at country level:

  • MSI (Meses sin interés): Base installment plans offered by PROSA. The customer's personal bank is responsible for collecting payments. You receive a single settlement that includes any deducted fees.

Step 2: Customize the checkout

As an optional feature, you can customize the appearance of the Web Checkout interface that your customers see. This lets the checkout experience match the branding of your e-commerce site. Available customization options include brand color, accent color, and font.

Step 3: Set the redirect URLs

Redirect URLs send customers to predefined endpoints when a transaction is approved or declined during checkout.

You must provide two URLs:

  • Success: for approved transactions.
  • Error: for declined transactions.

Both URLs are required to complete the integration.

Step 4: Configure webhook notifications

A webhook is a lightweight, event-driven communication mechanism that lets one app automatically notify another via HTTP. This approach removes the need for continuous polling. It supports near real-time data exchange and system integration.

To implement a webhook, the client gives the server API a unique webhook URL and specifies the events it wants to receive. In the final step of the checkout configuration in the Merchant Portal, you must provide a fully qualified webhook URL (server endpoint).
In addition, a username and password are required. Getnet includes these credentials as a base64-encoded value in the Authorization header of each notification. Your server uses them to validate that the notification came from Getnet.
Once you configure the webhook, Getnet automatically sends notifications to the specified URL whenever a transaction event occurs. Each notification includes the original payment data and a result object. This object is nested within the top-level payment object and contains the payment status and authorization details.

Even though you don't need to send a formal acknowledgment, your system must return a successful 200 HTTP response. If your system returns an error 500 HTTP response or no response at all, Getnet resends the notification. It makes up to 5 attempts at increasing intervals.

After these initial 5 attempts, Getnet resends the notification every 1 hour for up to 72 hours. After that, Getnet stops further notification attempts.

Although a formal acknowledgment isn't required, your system must return an HTTP 200 (OK) response when it receives a webhook notification. If your system returns an HTTP 500 (ERROR) response, or no response, Getnet retries the notification.

Getnet resends the webhook notification up to five times at progressively increasing intervals. If delivery still fails after these initial attempts, retries continue once per hour for up to 72 hours. After this period, Getnet stops any further notification attempts.
Example of an AUTHORIZED transaction payload:
JSON
{ "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": "johndoe@emailtest.com", "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" }
Example of a DENIED transaction payload:
JSON
{ "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": "johndoe@emailtest.com", "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" }

For more details, see the API reference.

On this page

Configure Web Checkout in the Merchant Portal