Skip to content
English
Go to PAY.NL
  • There are no suggestions because the search field is empty.

Exchange Settings (Webhooks)

The exchange URL links your server directly to our payment actions for secure and automatic processing

In this Sales Location menu you can configure the settings for the Exchange integration. You indicate whether you want to use a dynamic or static Exchange URL, select the call method (such as TXT, XML, JSON), set a separator, and choose a retry scheme for retrying failed calls. In addition, you determine which status updates should be communicated via the Exchange, for example all statuses, only paid orders, or only changes in order statuses.

Institution Value
Setting up Exchange
  • Yes, pass via the API or plugin (most commonly used)
  • Yes , use a static Exchange URL
Exchange URL Url: https://
Call method
  • TXT (POST)
  • TXT (GET)
  • XML (POST)
  • JSON (POST)
  • SIGNED JASON (POST)
Separator
  • , (comma)
  • | (pipe)
Return scheme
  • 10 times within 24 hours with increasing intervals
  • 1 time (after 5 seconds)
  • 6 times within 2 hours with increasing intervals
  • 8 times, every exchange call after fifteen minutes
  • 11 times within 24 hours (balanced)
Communication status
  • ALL (Pendings, Order statuses and flow changes with details)
  • PAYMENT COMPLETE ONLY (only once order is paid and money has been received (NEW_PPT)
  • ORDER CHANGE (If order statuses change, no pendings)
  • CHANGES NO PENDINGS (Order and cash flow changes, no pending statuses)

Retry Scheme Intervals

The retry scheme repeats a failed Exchange call according to preset intervals until the server returns "TRUE". This confirms that the request has been processed successfully. By using different intervals between retries, server overload is prevented and the chance is increased that a temporary problem will be resolved before the request is tried again.

Retry moment 10x / 24h (increasing) 11x / 24h (balanced) 8x / quarter hour 6x / 2h 1x / 5s
1st retry after: 1 second 10 seconds 15 minutes 30 seconds 5 seconds
2nd retry after: 3 seconds 30 seconds 30 minutes 50 seconds -
3rd retry after: 10 seconds 1 minute 45 minutes 70 seconds -
4th retry after: 30 seconds 2 minutes 60 minutes 5 minutes -
5th retry after: 60 seconds 1 hour 75 minutes 30 minutes -
6th retry after: 5 minutes 3 hours 90 minutes 60 minutes -
7th retry after: 30 minutes 6 hours 105 minutes - -
8th retry after: 60 minutes 10 hours 120 minutes - -
9th retry after: 12 hours 14 hours - - -
10th retry after: 24 hours 19 hours - - -
11th retry after: - 24 hours - - -

Status Communication

With status communication, you decide for yourself which transaction statuses are forwarded to the Exchange URL. This way you only receive relevant notifications, avoid unnecessary notifications, and can manage your workflows more efficiently.

Type Action Code All Payment complete only Order
change		 Changes not pending

Pending status

 pending 20 ✔ ✖ ✖ ✖
pending 25 ✔ ✖ ✖ ✖
pending 50 ✔ ✖ ✖ ✖
pending 90 ✔ ✖ ✖ ✖
Order change new_ppt 100 ✔ ✔ ✔ ✔
cancel -90 ✔ ✖ ✔ ✔
cancel -80 ✔ ✖ ✔ ✔
authorize 95 ✔ ✖ ✔ ✔
capture 100 ✔ ✔ ✔ ✔
refunding -72 ✔ ✖ ✔ ✔
refunded -81 ✔ ✔ ✔ ✔
denied -63 ✔ ✖ ✔ ✔
denied -64 ✔ ✖ ✔ ✔
failure -60 ✔ ✖ ✔ ✔
verify 85 ✔ ✖ ✔ ✔
chargeback -71 ✔ ✖ ✔ ✔
chargeback reversal 100 ✔ ✔ ✔ ✔
Mutation (action) refund:add -72 ✔ ✖ ✔ ✔
refund:delete 100 ✔ ✔ ✔ ✔
refund:received -81 ✔ ✔ ✔ ✔
refund:cancellation 100 ✔ ✔ ✔ ✔
collection:add 50 ✔ ✖ ✔ ✖
collection 100 ✔ ✔ ✔ ✔
collection:deleted   ✔ ✖ ✔ ✔
direct debit reversal -63 ✔ ✖ ✔ ✔