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

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

Endpoint: /api/v1.1/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
transaction	Object	Dữ liệu thanh toán
transaction.status	String	Trạng thái giao dịch
transaction.amount	Integer	Số tiền thanh toán
transaction.currency	String	Mã tiền tệ (mặc định: VND)
transaction.orderId	String	Mã đơn hàng
transaction.bankCode	String	Mã ngân hàng
transaction.paymentMethod	String	Phương thức thanh toán
transaction.paymentType	String	Loại thanh toán (mặc định: WEB)
transaction.appotapayTransId	String	Mã giao dịch phía AppotaPay
transaction.transactionTs	Integer	Thời gian giao dịch
transaction.extraData	String	Thông tin bổ sung đối tác truyền sang API
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}&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"
}