Initial Configuration via Merchant Portal

This document applies to the following countries:

ArgentinaChileMexico
information icon

For other countries check the Initial Configuration via API document.

To process transactions using Web Checkout, four steps configurations must be completed in the Web Checkout module of Getnet's Merchant Portal.

Step 1: Payment and Installment options

Merchants can optionally configure their checkout experience by enabling or disabling specific payment operations. These settings determine which payment methods, such as Credit Cards and Debit Cards, are displayed during the checkout process.

This flexibility allows merchants to offer the payment options that best meet their business and customer needs.

Merchants can also configure the installment options available to their customers, allowing them to define key aspects of the installment experience. These configurations include the installment plans to be offered, the number of installments available, and the party responsible for absorbing interest fees, which may be assumed by the cardholder or by the merchant.

Argentina Installments

There are two main types of installments options offered at country level, and can only be processed with national or domestic cards:

  • Issuer plans: Base installment plans are offered by the Issuer/Banks.
  • Government plans (Cuota Simple / Plan Ahora): Option offered by the Argentinian government usually at lower interest fees than the Issuer plan.

Chile Installments

There are two main types of installments options offered at country level:

  • Issuer plans: Base installment plans are offered by the Issuer/Banks with options that come within a range from 2 to 48. The merchant will settle the transaction only once and the cardholder will pay the total amount and any corresponding fees applied afterwards.
  • Merchant installments (Cuota Comercio): No fees plan offered by the merchant with options that come within a range from 2 to 12. The merchant will settle the transaction multiple times, depending on the selected plan.

Mexico Installments

There is one main type of installment option offered at country level:

  • MSI (Meses sin interés): Base installment plans are offered by PROSA in which the customer's personal bank is responsible for collecting payments, while the merchant will receive a unique settlement that includes any deducting fees.

Step 2: Customize the checkout

As an optional feature, merchants can customize the appearance of the Web Checkout interface displayed to customers. This allows the checkout experience to align with the branding of the merchant’s e-commerce site. Available customization options include brand color, accent color, and font.

Step 3: Redirect URLs

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

Two URLs must be provided:

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

Both URLs are required to successfully complete the integration.

Step 4: Webhook Notifications

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

To implement a webhook, the client provides a unique callback URL to the server API and specifies the events it wishes to receive, you must provide a fully qualified callback URL (server endpoint) in the final step of the checkout configuration process within the Merchant Portal.
In addition, a username and password are required. These credentials will be included as a base64-encoded value in the Authorization header of each notification sent by Getnet and should be used by your server to validate that the notification originated from Getnet.
Once the webhook is configured, Getnet will automatically send notifications to the specified URL whenever a transaction event occurs. Each notification includes the original payment data, along with a result object, nested within the top-level payment object, which contains the payment status and authorization details.

Even though you do not need to send a formal acknowledgement, your system must return a successful 200 HTTP response. In the event of returning an error 500 HTTP response or no response at all, the webhook notification will be resend up to 5 attempts at increasing intervals.

After these initial 5 attempts, the notification will be resend every 1 hour for up to 72 hours, at which point, Getnet will cease further notification attempts.

Although a formal acknowledgment is not required, your system must return an HTTP 200 (OK) response upon receiving a webhook notification. If an HTTP 500 (ERROR) response is returned, or if no response is received, the notification will be retried.

Getnet will resend the webhook notification up to five times at progressively increasing intervals. If the notification is still not successfully delivered after these initial attempts, retries will continue once per hour for up to 72 hours. After this period, Getnet will stop 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

Initial Configuration via Merchant Portal