Skip to main content

Recharge callback notification

Webhook

When the recharge order status changes to success or failure, the merchant will receive a recharge callback notification, and the merchant needs to update the local order status based on the callback notification.

info

Merchants can add a recharge callback address (a publicly accessible HTTPS protocol URL) in the Pay Protocol management platform's orgnization information. When the recharge result is confirmed, the system will send a successful recharge notification to this URL.

The callback will be sent up to 6 times, respectively at 0 seconds, 15 seconds, 30 seconds, 3 minutes, 5 minutes, and 10 minutes after the recharge is confirmed.

When the merchant returns success normally, the system will consider the callback successful and will not send subsequent callbacks.

Note: The merchant needs to verify the signature of the callback notification to ensure the security of the notification. The signing method of the callback is consistent with the normal request.

Request​

Body

required

    chainId int32required

    Chain ID

    This is the platform internal ID, not the chain ID on the chain or from the wallet, can be obtained from Get Chain List interface

    rechargeId int32required

    Recharge order ID

    userId int32required

    User ID

    uuid stringrequired

    User UUID

    currencyId int32required

    Currency ID

    Can be obtained from Get Currency List interface

    rechargeAmount stringrequired

    Recharge amount

    Note: The value of this field is an integer, calculated by (actual_amount * 10^currency_decimals)

    rechargeStatus int32required

    Possible values: [0, 1, 2]

    Recharge order status

    • 0 - Success
    • 1 - Pending
    • 2 - Failure
    transferHash stringrequired

    Transaction hash

    walletId int32required

    User sub-contract wallet ID

    walletAddress stringrequired

    User sub-contract wallet address

    fromAddress stringrequired

    Sender address

    createTime date-timerequired

    Order creation time

    blockTime date-timerequired

    Transaction confirmation time

Responses​

OK

Schema

    string

    Possible values: [success]

Loading...
Last updated on