Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-en.basswallet.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST Callback URL configured by the merchant
When a user makes a payment for a payment order, the platform will trigger two callbacks. If the user does not complete the payment within the order’s expiration time, a callback will be sent with an expired status.

​
Request Parameters

ParameterData TypeRequiredDescription
webhookTypeStringYesWebhook type, set to Payment.
idStringYesOrder ID.
statusStringYesOrder status. See the order status enum for details.
chainNameStringYesBlockchain name.
tokenNameStringYesToken name.
fromAddressStringYesSender’s address.
toAddressStringYesRecipient’s address.
txHashStringYesOn-chain transaction hash.
amountStringNoPayment amount set by the merchant.
amountActualStringYesActual amount paid by the user.
amountUSDStringYesActual amount paid in USD.
businessIdStringNoMerchant-defined order ID.
timestampLongYesUNIX timestamp (in milliseconds).

​
Request Parameters (When Order is Expired)

ParameterData TypeRequiredDescription
webhookTypeStringYesWebhook type, set to Payment.
idStringYesOrder ID.
businessIdStringNoMerchant-defined order ID (if any).
statusStringYesOrder status, set to Expired.
timestampLongYesUNIX timestamp (in milliseconds).

​
Request Example

{
    "amount": "10.88",
    "amountActual": "10.88",
    "amountUSD": "10.11",
    "blockConfirmNum": 1,
    "blockHigh": 51259775,
    "chainName": "Tron",
    "fromAddress": "TKjLDbk7LC9NXzRBCYahKa8pzMHRfahJjn",
    "id": "603277493897662464",
    "status": "WaitingConfirmation",
    "toAddress": "TTSgF6XEd1TbEH3fPuC4Zypn7UZsxetEcH",
    "tokenName": "USDT",
    "txHash": "a43d0157e327da5fe5912e5ff91939a4c142cfa1ebedea0a40b4e118d35425d2",
    "webhookType": "Payment",
    "timestamp": 1729476831813
}