Skip to main content

Overview

Payment and payout notifications are sent when a transaction status is changed for a transaction. Notifications will be posted to the merchant notification url configured in the merchant portal.

Note 📌

All notification communications must be encrypted under TLS/SSL and be a HTTPS endpoint

Note 📌

Validate the notification request using signatures. More information her.

Once a notification is received a HTTP response with status code 200 must be responded as acknowledgement, otherwise a new notification will be re-send after 60 minutes.

Merchant is able to resubmit a notification manually using the merchant portal.

Payin notification example.

{
"internalId": "fb488f37-8491-4e33-364f-93e7ww188ba3",
"transactionId": "fb488f37-8491-4e33-364f-93e72a188ba3",
"sessionId": "bc8d79c2-ba6c-41b9-beec-8te7fbf56218",
"merchantName": "Test",
"userId": "a9f775048c2bbd86a9a5e8785f0",
"type": "BANK",
"paymentOptionName": "Easy p2p",
"country": "eg",
"currency": "egp",
"paymentAmount": 300,
"payoutAmount": null,
"merchantReference": "mr-sfttarref",
"status": "completed",
"language": "en",
"paymentReference": "pr-fpltrea57laf",
"storedToken": null,
"extra1": null,
"extra2": null,
"extra3": null,
"customer": {
"_id": "2f6575d1-9e74-4db6-bbba-e836c16d8e91",
"customerId": "86629a8e-9074-414e-b31b-52933b7995bb",
"email": "[email protected]",
"name": "Test Test",
"phone": "0124589875456",
"userDevice": "MOBILE",
"userAgent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Mobile Safari/537.36",
"ip": "196.159.229.116",
"address": {
"street": "Test Mountain",
"streetNumber": "59994",
"country": "EG",
"zipCode": "2211",
"city": "Lake test",
"state": null
},
"identify": {
"number": "73428tf2-f23e-xxxx-9xxx-530d2083f8c2",
"type": "DNI"
}
},
"orderDetails": [],
"shippingAddress": null,
"bonusApplied": false,
"promoCode": null,
"cardDetails": null
}

Payout notification example.

{
"internalId": "fb488f37-8491-4e33-364f-93e72a188ba3",
"transactionId": "fb488f37-8491-4e33-364f-93e72a188ba3",
"sessionId": "bc8d79c2-ba6c-41b9-beec-8de7fbf56218",
"merchantName": "Test",
"userId": "",
"type": "PAYOUT",
"paymentOptionName": "Easy P2P",
"country": "EG",
"currency": "EGP",
"paymentAmount": null,
"payoutAmount": 1090.99,
"merchantReference": "71221234",
"status": "COMPLETED",
"language": "EN",
"paymentReference": null,
"storedToken": null,
"extra1": null,
"extra2": null,
"extra3": null,
"customer": {
"email": "[email protected]",
"name": "abc de",
"phone": "15201234343",
"_id": "28111299-d708-46f7-996e1222323dede3"
},
"orderDetails": [],
"shippingAddress": null,
"bonusApplied": false,
"promoCode": null,
"cardDetails": null
}