Skip to main content
Version: 1.1

Check transaction status

API check transaction status

Endpoint: /api/v1.1/orders/transaction/bank/status

Method: POST

Header: How to generate JWT_TOKEN

{
"X-APPOTAPAY-AUTH": Bearer JWT_TOKEN,
"Content-Type": "application/json"
}

HTTP Request:

ParamsSample
orderId5f5b46cb73fd0
signature3d4cf0f6130ee51f75714733922a7e76b1c18704187827a78abd379f4ab266ec

HTTP Response:

ParamsData typeDescription
errorCodeIntegerError Code
messageStringError detail
partnerCodeStringPartner Code
apiKeyStringPartner APIKEY
transactionObjectTransaction
transaction.statusStringPayment status
transaction.amountIntegerPayment amount
transaction.currencyStringCurrency code (default: VND)
transaction.orderIdStringOrder ID
transaction.bankCodeStringBank code
transaction.paymentMethodStringPayment method
transaction.paymentTypeStringPayment type (default: WEB)
transaction.appotapayTransIdStringAppotaPay transaction ID
transaction.transactionTsIntegerTransaction time
transaction.extraDataStringExtra data
signatureStringSignature check data

signature = HMAC_SHA256(data, secretKey)

data: amount={amount}&apiKey={apiKey}&appotapayTransId={appotapayTransId}&bankCode={bankCode}&currency={currency}&errorCode={errorCode}&extraData={extraData}&message={message}&orderId={orderId}&partnerCode={partnerCode}&paymentMethod={paymentMethod}&paymentType={paymentType}&status={status}&transactionTs={transactionTs}

Example Response

{
"errorCode":0,
"message":"Thành công",
"partnerCode": "TEST",
"apiKey": "oMhJpkz7K6HDcR6S",
"transaction": {
"status": "success"
"amount":50000,
"currency":"VND",
"orderId":"5f5b46cb73fd0",
"bankCode":"SHB",
"paymentMethod":"ATM",
"paymentType":"WEB",
"appotapayTransId":"AP200910014125B",
"transactionTs":1599817433,
"extraData":"test test",
},
"signature":"d6ff2d38c2b1167c6d17b9dbb1380347b24c1bf912dc442dbd018b2e1ed74f3d"
}