Kiểm tra trạng thái giao dịch

API kiểm tra trạng thái giao dịch

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

Method: POST

Header: Cách tạo JWT_TOKEN

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

HTTP Request:

Tham số	Ví dụ
orderId	5f5b46cb73fd0
signature	3d4cf0f6130ee51f75714733922a7e76b1c18704187827a78abd379f4ab266ec

HTTP Response:

Tham số	Kiểu dữ liệu	Mô tả
errorCode	Integer	Mã lỗi
message	String	Thông tin chi tiết mã lỗi
partnerCode	String	Mã đối tác
apiKey	String	Mã APIKEY gọi tới API
amount	Integer	Số tiền thanh toán
currency	String	Mã tiền tệ (mặc định: VND)
orderId	String	Mã đơn hàng
bankCode	String	Mã ngân hàng
paymentMethod	String	Phương thức thanh toán
paymentType	String	Loại thanh toán (mặc định: WEB)
appotapayTransId	String	Mã giao dịch phía AppotaPay
transactionTs	Integer	Thời gian giao dịch
extraData	String	Thông tin bổ sung đối tác truyền sang API
cardInfo	Object	Thông tin thẻ thanh toán
cardInfo.cardNumber	String	Số thẻ/ tài khoản
cardInfo.cardDate	String	Ngày hết hạn
cardInfo.cardName	String	Tên chủ thẻ/ tài khoản
cardInfo.countryCode	String	Mã quốc gia
signature	String	Chữ ký kiểm tra dữ liệu 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}&transactionTs={transactionTs}

Example Response

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