Thanh toán QrCode động

Thanh toán QrCode động

Chat với AI▼

Endpoint: /api/v1/orders/payment/qr

Method: POST

Header Params

Tham số	Yêu cầu	Kiểu dữ liệu	Mô tả	Lưu ý
X-APPOTAPAY-AUTH	required	String	Cách tạo JWT_TOKEN
Content-Type	required	String	Giá trị: application/json
X-Account-Ref-ID	optional	String	Mã định danh của tài khoản Sub account do AppotaPay cung cấp. Bắt buộc truyền khi thanh toán giao dịch của Sub account loại owner

{
    "X-APPOTAPAY-AUTH": "JWT_TOKEN",
    "Content-Type": "application/json",
    "X-Account-Ref-ID": "9723f73b-9295-4acb-884b-ab6310c2e653"
}

Tham số

Tham số	Kiểu dữ liệu	Yêu cầu	Mô tả
orderId	String	√	Mã đơn hàng phía đối tác
orderInfo	String	√	Thông tin đơn hàng(tối đa 150 kí tự)
amount	Number	√	Số tiền thanh toán
clientIp	String	√	Địa chỉ IP khách hàng thanh toán
notifyUrl	String	√	IPN URL nhận kết quả giao dịch
redirectUrl	String		URL chuyển hướng khi giao dịch hoàn tất
extraData	String		Thông tin tuỳ chọn bổ sung
signature	String	√	Chữ ký kiểm tra dữ liệu signature = HMAC_SHA256(data, secretKey) data: amount={amount}&clientIp={clientIp}&extraData={extraData}¬ifyUrl={notifyUrl}&orderId={orderId}&orderInfo={orderInfo}&redirectUrl={redirectUrl}

Dữ liệu trả về

Tham số	Kiểu dữ liệu	Mô tả
errorCode	String	Mã lỗi
message	String	Thông tin mô tả mã lỗi
orderId	String	Mã đơn hàng
amount	Integer	Số tiền thanh toán
paymentUrl	String	URL thanh toán
appotapayTransId	String	Mã giao dịch
qrData	Object	Thông tin qr code
qrData.qrCodeUrl	String	QR Code URL
qrData.qrCodeExpiryIn	Integer	Thời gian hết hạn của QR
signature	String	Signature generate theo thứ tự amount={amount}&appotapayTransId={appotapayTransId}&errorCode={errorCode}&message={message}&orderId={orderId}&paymentUrl={paymentUrl}&qrCodeExpiryIn={qrCodeExpiryIn}&qrCodeUrl={qrCodeUrl}

Ví dụ

Request

{
    "orderId": "u7XR9xfTj",
    "orderInfo": "test thanh toan",
    "amount": 10000,
    "notifyUrl": "http://yourwebsite.com/ipn",
    "redirectUrl": "http://yourwebsite.com/redirect",
    "extraData": "",
    "clientIp": "103.53.171.140",
    "signature": "c1ad6f769866d74003ffd4f7cf4f21230723c059e0744ec4fd75d16b8bff1001"
}

Response

{
    "errorCode": 0,
    "message": "Thành công",
    "orderId": "u7XR9xfTj",
    "amount": 10000,
    "paymentUrl": "https://payment.dev.appotapay.com/bank/payment/process?tran=dGlkPUFQMjIxNDM0NTk2NjQzJm9yZGVySWQ9dTdYUjl4ZlRqJnRzPTE2NTUwOTYwNDQ&sign=2212998138571e92b30222374163c82942bef1adde2c4972a3ec04d78b7134fe",
    "appotapayTransId": "AP221434596643",
    "qrData": {
        "qrCodeUrl": "https://scontent.appotapay.com/cms-report-files/qrcode/ap2214345966431655096045.png",
        "qrCodeExpiryIn": 1655355366
    },
    "signature": "fc06748cf4c32169d03d1935808e5a4e81b019c3173c1f396ce1aed482d936ba"
}

Error

{
    "errorCode": int,
    "message": error message
}