General Api Definition

Order Response Detail

Detail of Order response object

Attribute	Mandatory	Data Type	Description
fpTxnId	✔️	String	FastPay's code order
orderId	✔️	String	Merchant's order ID. This is correspond with orderId from request
totalAmount	✔️	Double	Customer's net amount
originalAmount	✔️	Double	Customer's amount
feeAmount	✔️	Double	Amount Fee is paid by user. Calculate by fee
fee	✔️	Double	Percent Fee is paid by user (%)
type	✔️	String	Command type from request. Value: deposit or withdraw
status	✔️	String	Order status. - init: Initial - processing: Processing - completed : Completed - cancelled: Cancelled
ticker	✔️	String	Ticker pair
exchangeRate		String	Exchange rate
exchangeAmount		String	Exchange amount
exchangeUnit		String	Exchange unit
timeout	✔️	Long	Time specify that the order will be expired. (Timestamp Miliseconds)
walletAddress	✔️	String	Deposit/Withdraw Wallet address
redirectUrl		String	redirectUrl correspond with request.
ipnUrl		String	ipnUrl correspond with request.
txid		String	Blockchain transaction ID when order status is completed
transactionTime		Long	Time of txid that show the transaction has been success (Timestamp Miliseconds)

Response example:

{
    "code": "SUCCESS",
    "responseTime": 1721718881532,
    "message": "Thành công",
    "detail": {
        "totalAmount": 0.0,
        "originalAmount": 0.0,
        "feeAmount": 0.0,
        "fee": 0.00135,
        "type": "deposit",
        "network": "BSC",
        "orderId": "deposit:spot:1721718821",
        "redirectUrl": "https://webhook.site/cd178d6d-17b8-4394-af9b-a9d58b1de161",
        "timeout": 1721718881532,
        "ticker": "USDT/VND",
        "walletAddress": "0x90E9937D0BfB1f74de6988171c501cdf7fC896B4",
        "payUrl": "https://sandbox.fastpay.finance/v1/gateway/qr?sessionId=MzI1OjY0NDpkZXBvc2l0OnNwb3Q6MTcyMTcxODgyMQ"
    },
    "signature": "3c7db8ca15d9875f16e14672b8d4bacde615551a48c71fa3e85d819bfaa37c60ddfebc883aa68b653ee8aea1335ae335e8e3f32a6055cb58c4b7de53c6657b00"
}

Status List

Detailed description of the status

Code	Description
SUCCESS	The request has been completed successfully
INSUFFICIENT_FUND	Account has insufficient funds
AUTHENTICATION_FAIL	Authentication request failed