Set Up Callback URL for Payment Gateway Integrations

A callback URL is an address that a server provides for receiving POST requests. Point of Sale generates a callback URL as part of the payment gateway configuration. When you use Adyen, you must configure a callback URL so Point of Sale can receive payment event notifications, such as payment failures. Without it, Point of Sale can’t update order status or handle failed payments. Set up the callback URL at the correct company or organization level in Adyen. If you configure it at the wrong level, Adyen can send callbacks for unrelated web orders, creating unnecessary bloat in failed order records.

For Point of Sale to receive Adyen callbacks related to payment failures, a callback URL is needed. This is similarly used in the case of HiPay for pay by link. Part of the configuration process requires a callback URL generated by Point of Sale. This article explains how to generate a callback URL and use it for Adyen and HiPay.

  1. In the CMS, go to Integrations | Payment Gateways.

  2. Create a new integration by clicking Create.

  3. For Payment Gateway, select an integration to configure.

  4. For Callback URL, click Generate.

  5. Copy the URL and configure it in the selected integration portal.

The callback URL is configured in the Adyen Portal at the appropriate Company or Merchant account level. The callback URL can't be configured at both the Company and Merchant level. For more information on integrating Adyen, refer to Adyen Payment Gateway Integration in Salesforce Help.

Configure the callback URL in Adyen at the Point of Sale merchant-region level. Each region requires a unique payment gateway setup with its own callback URL. For example, a DE region callback URL should be linked only to the DE Adyen account. Ideally, each Point of Sale merchant account maps 1:1 with an Adyen merchant account for a cleaner integration and accurate reporting.

Point of Sale also supports mapping multiple merchant accounts to one Adyen account if each uses a distinct order number range and Adyen is configured with multiple webhooks. However, this setup can cause false positives in the Failed Order report because all Point of Sale environments receive every webhook. Consult your Adyen representative to confirm the best configuration for your setup.

To facilitate in-store payments via PBL and for brands operating under a parent company, set up callback URLs or webhooks at the parent company level for each child branch. This consolidates all payments made across the child brands at the company level as each instance has one callback URL in CMS.

Similar to Adyen, in the case of HiPay, callback URLs are used for pay by link integration.

For more information, refer to Set Up HiPay Hosted Page Payments in Salesforce Help.