Provided you include the notification_url parameter in your request the system will send a notification to your chosen endpoint in the following format:
Example
YOUR ENDPOINT?reply_code=000&reply_desc=SUCCESS&trans_id=46942&trans_date=7%2F24%2F2022+5%3A13%3A44+PM
&trans_amount=29&trans_currency=1&trans_order=178389324789324&merchant_id=YOURCOMPANYNUMBER&client_fullname=penaud axdfel
&client_phone=330634207244&client_email=sdfdsf@gmail.com&payment_details=Mastercard .... 0000&trans_type=0&debit_company=146&debrefnum=2NPrJNCA&bin_country=FR
&pm=25&StorageID=0&ExpMonth=09&ExpYear=24&signature=E28DYI1W4DkCoQE7KCcbiLY94JoMyiCUauqy1M0gclQ%3D
| Parameter |
Description |
| reply_code |
Reply code provided from the system - list of reply codes can be found here Reply codes*/** |
| reply_desc |
The reason for the decline as it is provided from the provider or by the system - for further info contact Support |
| trans_id |
The transaction ID that is generate by our system |
| trans_date |
The time and date of the transaction - Time is set to GMT (URL Encoded) |
| trans_amount |
The amount of the transaction that was processed |
| trans_currency |
The currency in which the transaction was processed. (ISO Code - USD/EUR/GBP) |
| trans_order |
The order id that was sent by the merchant to our system - the unique identifier on the merchant CRM system. |
| payment_details |
This will return the payment method used and the last 4 digits on the card number if relevant |
| merchant_id |
The company id as it was provided to the merchant by Support (Company Number) |
| client_fullname |
The full name of the client that was included in the transaction. |
| client_phone |
The phone number of the client that was included in the transaction. |
| client_email |
The email address of the client that was included in the transaction. |
| payment_details |
Payment method name and last 4 digits in case of credit cards. |
| trans_type |
The type of the transaction. |
| debit_company |
In "cashier mode" is enabled you will receive the ID of the provider who processed the transaction. |
| debrefnum |
The identifier provided by the provider. |
| bin_country |
The country of which the card was issued at. |
| pm |
The Payment Method ID - the full list is avaiable under the list section. |
| StorageID |
The CC storage ID generated for the transaction when applicable. |
| ExpMonth |
The Expiration month of the card. |
| ExpYear |
The The Expiration year of the card. |
| signature |
base64( hash('sha256', trans_id + trans_order + reply_code + trans_amount + trans_currency + merchanthash)) |
* Reply codes are either from system or from the providers we work with - list of declines may change from time to time.
** Approved reply code would always be 000 and Pending would be 553.
*** Please be sure to support POST on your end to receive the notifcation
Chargeback notification
Learn about our chargeback notification formats and how to support the post-transaction notifications and statuses
Provided you include the notification_url parameter in your request the system will send a notification to your chosen endpoint in the following format:
Example
YOUR ENDPOINT?trans_id=32302&action=Chargback&reason=Card Not Valid or Expired&comment=final chargeback status&reasonCode=4801&originalID=31519&OrderId=13245&Signature=Jfn8R2llBecwyqB/Wihmse9Jzxa7nOaRtK+03VPPd1c=
| Parameter |
Description |
| trans_id |
The transaction ID that is generate by our system for the chargeback transaction |
| action |
The action taking place with two options: Chargeback or Retrieval |
| reason |
The reason passed from the issuer for the Chargeback / Retrieval |
| reasonCode |
The code of the reason passed from the issuer for the Chargeback / Retrieval |
| comment |
Additional text passed from our admins to describe the Chargeback |
| originalID |
The original transaction which we are marking as a Chargeback |
| OrderId |
Your order id for the original transaction |
| signature |
base64( hash('sha256', trans_id + action + reason + reasonCode + comment + originalID + OrderId + merchanthash)) |