Callback / Webhook

Information

danger

Before you start receiving callbacks from us, make sure to whitelist our IP Addresses on your server, contact Administrator to get our IP list.

info

• The callback are available on JSON POST, POST, GET method (you can choose your prefered method).
• Default callback method are JSON POST.

Request Body or Parameter

Name	Nullable?	Description
trxId	No	Unique Transaction ID generated by Neropass
refId	Yes	Unique Reference ID from your system
productCode	No	Neropass Product Code
userId	Yes	Destination User ID
serverId	Yes	Destination Server ID
username	Yes	Destination Username
voucher	Yes	Voucher Code
phone	Yes	Destination Phone Number
reference	Yes	Transaction Reference
status	No	Transaction Status, possible callback status: REFUND, SUCCESS
message	No	Transaction message, sometime can be error code for failed transaction
balance	No	Latest balance
createdAt	No	Transaction data (YYYY-mm-dd HH:ii:ss)
hash	No	Callback hash for extra security: md5(trxId + productCode + callbackToken)

caution

• Data marked as nullable can be null or empty, make sure to handle it properly on your side.

Callback Example

Example JSON POST Body

{
    "trxId": "TR646FB1F411AE7NHBHFPSM",
    "refId": "TEST2",
    "productCode": "GFFD5",
    "productPrice": 855,
    "userId": "1234567890",
    "serverId": null,
    "username": "LoremImpsum",
    "voucher": null,
    "phone": null,
    "reference": "S1234567890123456",
    "status": "SUCCESS",
    "message": "COMPLETED",
    "balance": 329382123,
    "createdAt": "2023-05-26 02:07:33",
    "hash": "a94814c51b1a94be9c021aca11a0ffea"
}

Example POST Body

We're Using x-www-form-urlencoded on standard POST request

trxId=TR646FB1F411AE7NHBHFPSM&refId=TEST2&productCode=GFFD5&productPrice=855&userId=1234567890&username=LoremImpsum&reference=S1234567890123456&status=SUCCESS&message=COMPLETED&balance=329382123&createdAt=2023-05-26+02%3A07%3A33&sign=a94814c51b1a94be9c021aca11a0ffea

Example GET Request

https://example.com/callback?trxId=TR646FB1F411AE7NHBHFPSM&refId=TEST2&productCode=GFFD5&productPrice=855&userId=1234567890&serverId=&username=LoremImpsum&voucher=&phone=&reference=S1234567890123456&status=SUCCESS&message=COMPLETED&balance=329382123&createdAt=2023-05-26%2002%3A07%3A33&hash=a94814c51b1a94be9c021aca11a0ffea