Crypto Callback (Deposit Status)

Get callback notifications (webhooks) whenever there are any deposits or withdrawals to or from your addresses that you would like to be notified about.
Get information on balances, fees, and any other data on demand without having to manage or fetch vast blockchain databases and nodes.

POST POST https://{merchant_callback_URL}/


return

QUERY PARAMETERS

FieldTypeDescription
referCodestring(*Required) Reference code by merchant unique code. * Unique.
Example: RF-5242214199
docNostring(*Required) Document No Generate by gateway system. * Unique.
Example: WD8888888888
receiptCodestring(*Required) Transaction Hash & Transaction Receipt.
Example: e793cff685397ff849d45e8b1eeab13b2f2e2d8b634162d86729ec6a9a6d14713
fromAccstring(*Required) Withdrawal from the Account of Crypto Address.
Example: TXf5jhWZGYDYmsSU3AQkQ8tYiUoY4DxVsV
toAccstring(*Required) Withdrawal to the Account of Crypto Address.
Example: TXf5jhWZGYDYmsSU3AQkQ8tYiUoY4DxVsV
coinCodestring(*Required) Coin Code. Eg. ETH / TRX.
Example: TRX
currencyCodestring(*Required) This currency symbols codes of the currencies supported to specify the currency of monetary. Eg. USDT / USDC.
Example: USDT
amountfloat(*Required) The amount in currency to be transferred. * Maximun supported 4 decimals.
Example: 87.8700
transTypestring(*Required) Transaction Type. Eg: DEPOSIT / WITHDRAW.
Example: DEPOSIT
transStatusstring(*Required) Transaction Status. Eg: PENDING / PROCESS / FAILURE / CONFIRM.
Example: PENDING
feefloat(*Required) Charge the fee for each transaction amount. * Maximun supported 4 decimals.
Example: -1.6162
createdBystring(*Required) Transaction Owner name / User name.
Example: transaction_user_owner
createdAtstring(*Required) Transaction Date & Time. * Datetime format : yyyy-MM-dd HH:mm:ss
Example: 2022-01-04 13:29:46
xSignaturestring(*Required) Verification of Key from Callback Result. Implemented by using signing and verification of the input.
Example: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
pymtReasonstring(*Required) Payment Reason.
Example: COMPLETED

request

QUERY PARAMETERS

FieldTypeDescription
rSignstring(*Required) Sign the source string.
Example: MD5( xSignature + docNo + referCode + secret-Key )
take note:

When submitting the "amount" please ensure that it includes exactly four decimal places.
- For example to meet the formatting criteria:

incorrect should be entered
8888.0000
188.1000188.0100
11.0000

When submitting the "fee" please ensure that it includes exactly four decimal places.
- For example to meet the formatting criteria:

incorrect should be entered
-88-88.0000
-188.1-188.0100
-1-1.0000

Before implementing crypto deposits, please provide a crypto deposit orphan callback for orphan crypto deposit cases. In this context, an 'orphan case' refers to a situation where a member transfers tokens to a crypto receiver address without using the merchant API. SecretPay will use this URL to callback the merchant.

Updated over 0 months Ago