Push
For each completed transaction process, a notification is sent asynchronously to the defined notification URL. The notification is sent with the POST HTTP method and contains the standard response parameters. During a transaction, you can receive several notifications with different status. This means that a transaction can, in very rare cases, change from status “failed” to “captured”. On the other side, if a transaction is set to “captured”, it cannot come back to “failed” or “pending”. Pay close attention to credit your customers once even if you receive a “captured” status multiple times. For various reasons, sometimes the push notification does not lead to your server. This is never 100% reliable. We recommend in this case to exceptionally use the pull method to fetch yourself the status of a transaction if you do not get a notification after several minutes.
For push feature, please provide us URL from your system.
If the IPN cannot be delivered to you URL, We will try to re-send the IPN in one hour. This is processing for ten times.Basically, we will try to send the IPN ten times in ten hours.
Security
We highly recommend that integrate IPN integration and accept only our IP requests to your end point
Test environmentIP ADDRESS : 35.187.167.26
IP ADDRESS : 35.205.153.149
IP ADDRESS : 35.195.39.227
Live environmentIP ADDRESS : 35.233.71.4
IP ADDRESS : 104.155.117.86
IP ADDRESS : 35.189.219.45
Checksum
We highly recommend to control checksum with IPN call. You will receive token with IPN request this token will be hashed
secretKey apiKey code status amount currency referenceNo timestamp
<?php
$request = $_REQUEST;
$secretKey = 'YOUR_SECRET';
function generateToken($request, $secretKey) {
$rawHash = $secretKey . $params['apiKey'] . $params['code'] . $params['status'] . $params['amount'] . $params['currency'] . $params['referenceNo'] . $params['timestamp'];
return md5( $rawHash );
}Successful request from IPN
| Parameter name | Details | Example | Type | Is Required |
|---|---|---|---|---|
| code | Meaningful response code for merchant system | 02 - Response Code List | String | ✔ |
| status | The API request status. | APPROVED - Status List | Char 64 | ✔ |
| message | Status message | Auth3D is APPROVED | Char 256 | ✔ |
| type | Transaction type | Please Check Types | Char 256 | ✔ |
| operation | Transaction operation | Please Check Operations | Char 256 | ✔ |
| referenceNo | Your own transaction identifier. | 1-1386413490-0089-14 | Char 32 | ✔ |
| transactionId | Our unique transaction identifier. | 9-1438782271-1 | Char 32 | ✔ |
| amount | Amount in cents of the transaction | 1234 (12.34 € for example) | Int | ✔ |
| currency | The currency of the transaction. | EUR | Char 3 | ✔ |
| paymentMethod | Customer Payment Method | VISA - Supported payment methods | Char 32 | ✔ |
| timestamp | Date and time | 1533543919 | ✔ | |
| token | Code generated | 98ca055ed2797f53c5144f4 | Char 34 | ✔ |
| creditCard | The credit card information. | Please Check Creditcard | ||
| storedCardId | Only sent if the card stored by merchant for supported payment methods | 6-1474539891-0-1 | Char 32 |
Creditcard
| Parameter name | Details | Example | Type |
|---|---|---|---|
| number | Masked Credit Card pan number | 401288XXXXXX1881 | Char 32 |
| expiryMonth | The card expiration month. | 12 | Int 2 |
| expiryYear | The card expiration year | 2019 | Int 4 |
| Customer email address. | [email protected] | Char 256 | |
| birthday | The customer birth date. | 1970-01-01 | YYYY-MM-DD |
| billingFirstName | First name of the customer. | John | Char 64 |
| billingLastName | Last name of the customer. | Doe | Char 64 |
| billingAddress1 | The customer address 1. | 26 green street | Char 128 |
| billingCity | The customer city. | Paris | Char 64 |
| billingPostcode | The customer zip code. | 75001 | Char 16 |
| billingCountry | The customer state. | FR | Char 2 |
Status Codes
- APPROVED (Purchase successfully received)
- DECLINED (Purchase declined because of acquirer reasons)
- CANCELED (Transaction canceled by customer)
- PENDING (Customer did not select any payment and try to purchase or canceled)
- WAITING (Async payment methods, result will be inform by push method. Bank Transfer, Withdraw, Mobile Banking)
- ERROR (System Throws Exception)
Transaction Operations
- 3DAUTH (3D Purchase)
- DIRECT (Direct Purchase)
- STORED (Stored Purchase)
- REFUND (Refund)
Transaction Types
- AUTH (Auth Transaction)
- PREAUTH (Preauth Transaction)
Updated about 1 year ago