A callback is an optional POST HTTP request that makes against your project's callback URL each time a payment was confirmed.

As soon as we secure the funds, we will mark the invoice as PAID on our end. If allowed in your project's settings, we will make a POST request against the provided URL with the following:

interface IAmwalExchangeCallBack { invoiceId: string; // invoice ID paymentSessionId: string; // payment session ID secret: string; // unique private code } 

Callback payload example:

{ invoiceId: '65448ddef4924a5dd1b241a9', paymentSessionId: '6545360496c8b48eeab3837e', secret: '0927f7cc-98a7-4b67-a8b5-254fe46227dd', } 

Callbacks are highly recommended to automate the delivery process on your end. You can enable/disable the callbacks in your project's settings page as well.

Your endpoint should return HTTP code 200

It is your responsibility to provide us with a fully working callback URL.

All callback attempts (SUCCESS and FAILS) are logged in your accounts corresponding page.

We retry failed requests up to 30 times

over 3 day before we give up on a given payment confirmation.

All failed attempt will be followed by an E-mail

about the incident so you can track down the invoice in the system and do it right for your customer. You can enable/disable this per project.


All paid invoices are listed in your account's corresponding section.

All callbacks are logged as well.

Keep the secret

secret is used to link invoices to your project invoices.

it is your duty to capture this code on the invoice creation stage and assign it to your customer's shopping card or the delivery session.