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

Request

Header Params

Accept

string

optional

Example:

application/json

Content-Type

string

required

Example:

application/json

Body Params application/json

partner_code

string

required

Mã đối tác do PosApp cung cấp

request_id

string

required

Định danh duy nhất cho mỗi yêu cầu.
Đối tác sử dụng requestId để xử lý idempotency

lang

string

required

Ngôn ngữ của message được trả về (vi hoặc en)

signature

string

required

Chữ ký để xác nhận giao dịch. Sử dụng thuật toán Hmac_SHA256 theo định dạng chuỗi sắp xếp tất cả tên khóa của trường dữ liệu từ a-z: request_id=123&lang=vi

Example

{
    "partner_code": "PAC1234567",
    "request_id": "d3d9c551-ab6a-4efd-bba5-c9b99abb6812",
    "lang": "vi"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://retail-api.posapp.vn/api/public/posapp-cards/query' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partner_code": "PAC1234567",
    "request_id": "d3d9c551-ab6a-4efd-bba5-c9b99abb6812",
    "lang": "vi"
}'

Responses

🟢200Success

application/json

Body

partner_code

string

required

Mã đối tác (PosApp cung cấp)

request_id

string

required

Định danh duy nhất cho mỗi yêu cầu.
Đối tác sử dụng requestId để xử lý idempotency

card_id

string

required

Mã thẻ được phát hành từ phía PosApp

amount

integer

required

Số tiền cần nạp

posapp_trans_id

string

required

Mã giao dịch của PosApp

order_id

string | null

optional

Mã đơn hàng của đối tác

order_info

string | null

optional

Thông tin đơn hàng

paid_at

string

required

Thời gian xử lý giao dịch thành công. Định dạng ISO UTC. VD: 2024-07-24T07:18:24.000000Z

message

string

required

Mô tả lỗi, ngôn ngữ dựa trên lang

result_code

string

required

Mã lỗi

extra_data

string | null

optional

Thông tin thêm (định dạng base64)

lang

string

required

Ngôn ngữ của message được trả về (vi hoặc en)

signature

string

required

Chữ ký

Example

{
    "partner_code": "PAC1234567",
    "request_id": "d3d9c551-ab6a-4efd-bba5-c9b99abb6812",
    "card_id": "NRP0CPBJWX",
    "amount": 10000,
    "posapp_trans_id": "9dafcf76-6f58-48b1-8fb9-9ce136d6568d",
    "order_id": "13475873434",
    "order_info": "Nap the cho NV1 voi don hang NT001",
    "message": "Nạp tiền thành công",
    "extra_data": null,
    "lang": "vi",
    "signature": "b6e3dcd3bcc3b27a0f10a8b7448528782782fddb1dcc92c42227e8a8536c7c57"
}

🟠400Bad Request