Webhooks

Webhooks are a method of communication between two applications in real time. They enable merchants to receive notifications or trigger actions automatically when certain events occur in the payment system.

We use webhooks to notify you about the important events on your account. These webhooks contain details of the event such as changes in the transaction status and the resource impacted by the change.

We send webhooks as an HTTP POST call to a URL configured while Onboarding. The webhook payload uses the JSON format.

📘

Note:

• Contact our support team to set up a URL to receive webhooks from Pine Labs Online.

By integrating with webhooks, merchants can automate various tasks, such as updating order statuses, sending confirmation emails, or updating inventory levels, without manual intervention.

👍

Good to Know

• Webhooks are asynchronous, so for time-sensitive actions, we recommend polling our API.
• We attempt to send webhook events up to three times if the initial delivery to the merchant fails. Please wait for 5 seconds while we complete these retries. If the webhook event is still not received within this period, it is recommended to use the Get Order API to obtain the updated order status.

Network Address Translation [NAT] Gateway IPs to Whitelist

To ensure your integration is secure, configure your servers to accept communications only from the following IP range and address. Please ensure the following IP addresses and ranges are added to your firewall allowlist.

UAT/Sandbox Environment

Utilize the following IP addresses for traffic routing and API communication in non-production environments.

• 15.206.155.74 New
• 13.202.206.188 New
• 13.202.213.132 New
• 13.126.41.142 New

Production Environment

Utilize the following IP addresses for traffic routing and API communication in production environments.

• 18.61.136.235 New
• 40.192.21.254 New
• 18.60.11.185 New
• 13.200.147.61
• IP Range: 13.201.195.80/28