This is the instant payment notification solution will notify the merchant’s system once payment changed status, this is done on merchant shops url and can be setup from your merchant portal per shop.
Invoice IPN Callback.URL according to the related shop (Callback URL)
{
"nonce": "string",
"signature": "string",
"int_event_id": "string",
"int_transaction_id": "string",
"blockchain_transaction_id": "string",
"merchant_reference_id": "string",
"type": "string",
"amount": "number",
"settled_amount": "number",
"currency": "string",
"exchanged_amount": "string",
"exchanged_currency": "string",
"rate": "string",
"status": "string",
"ref_customer_id": "string",
"int_customer_id": "integer",
"address": "string",
"destination_tag": "string",
"callback_created_at": "string",
"shop_id": "integer",
"created_at": "string"
}Invoice IPN Body
nonce*
This is a unique Identifier for signature
signature*
The HMAC signature is used for callback authentication. To verify that the callback was sent by us, Merchant Core should generate an HMAC signature using SHA-256 as following:
key: nonce, username, password
message: customer_id
'signature': 'd9d2c15e62aa988b2d1355a07b236a046d270e462db33615f127b0bf7c67cd97'
int_event_id*
This is the webhook id. Example: 'int_event_id': '10'
int_transaction_id*
This is the system order id. Example: 'int_transaction_id': '1000'
blockchain_transaction_id*
This is the blockchain transaction id. Example: 'blockchain_transaction_id': 'cbd3dea703bd2bc78bca69ee61ca14e6ffcdd809d07ebbc3b8fea3c30ea38f33'
merchant_reference_id
This is the invoice reference id on the merchant side for validation purposes. Example: 'merchant_reference_id': '102342300'
type*
This is the callback type. Example: 'type': 'invoice_crypto_deposit'
amount*
This is the amount of the deposit. Example: 'amount': '0.00050000'
settled_amount*
This is the settled amount until now, from all blockchain deposits that happened. Example: 'settled_amount': '0.00050000'
currency*
This is the currency code of the amount received. Example: 'currency': 'BTC'
exchanged_amount*
This is the exchanged amount
exchanged_currency*
This is the currency code is used as the final Merchant currency/wallet to deposit the received money to.
rate
This is the exchange rate is used between the wallet_currency and exchanged_wallet_currency
status*
This is the callback status and it is according to the order status. Possible values are the following:
Processing - Invoice is requested to be paid
Partially Completed - Invoice is partially paid
Completed - Invoice is paid
Declined - Invoice is Declined for payment
Cancelled - Invoice is Cancelled for payment
Failed - Invoice is failed to be paid due to an error
Expired - Invoice is expired due to time out or other reasons
ref_customer_id*
This is the customer id provided once the e-wallet address was created. Example: 'customer_id': '54QFSA02901'
int_customer_id*
This is the internal customer id created in the system. Example: 'int_customer_id': '9887102901'
address*
This is the wallet address the deposit was created for. Example: 'address': '3GTMbi5iQH5nArvuEGsk6Vco9AmbmpwgkS'
destination_tag
This is the destination tag the deposit was created for. Example: 'destination_tag': '12345678'
callback_created_at*
This is the callback timestamp in the system. Example: 'callback_created_at' : '2018-11-16 13:10:59'
shop_id*
This is the internal shop id is related to this payment request, based on the used credentials
created_at*
This is the deposit timestamp in the blockchain. Example: 'created_at' : '2018-11-16 13:10:59'
