Create a deposit order

POST

/api/pay/unifiedOrder

Payment method code

Scan code (qr) type code

Scan code	Scan name
QR	QR

Bank VA Type Code

VA Code	Bank Name
BIDV	BIDV
MSB	MSB
TCB	TCB

Limit information

	Deposit amount rules
Deposit channel	Minimum single transaction	Maximum single transaction
QR	50,000	300,000,000
VA	10,000	299,999,999

Request

Header Params

Body Params application/json

Example

{
    "amount": "100000",
    "currency": "VND",
    "customerName": "DW",
    "mchNo": "M1688454487",
    "mchOrderNo": "VN31420230300564",
    "notifyUrl": "http://47.241.33.220:8896/tarspay/notify",
    "returnUrl": "https://www.tarspay.com/notify/return",
    "wayCode": "QR"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/pay/unifiedOrder' \
--header 'X-API-KEY: 02d6433f5bedc5bc35b0971b8acce048b2ad4bce74210bea1288a10f42b166e057' \
--header 'X-API-NONCE: 1704183963685' \
--header 'X-API-SIGNATURE: 3046022100e3f77085dd40cd803ed5b74f909b1e775bb0b1a795cd2a464a7258479d663bb6022100f27c27d29d840e641119a2aa4c8126d755e9e16c2965cec51f296a20e34ebdd9' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "100000",
    "currency": "VND",
    "customerName": "DW",
    "mchNo": "M1688454487",
    "mchOrderNo": "VN31420230300564",
    "notifyUrl": "http://47.241.33.220:8896/tarspay/notify",
    "returnUrl": "https://www.tarspay.com/notify/return",
    "wayCode": "QR"
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "data": {
        "accountName": "TRAN NGOC HIEU",
        "accountNumber": "100349617",
        "amount": "200000",
        "body": "test",
        "cashierUrl": "https://checkout-test-vn.tpservice.vip/#/pay/P439266522884476929",
        "countryCode": "vn",
        "currency": "VND",
        "customerContact": "03005331179",
        "expiredTime": 1777346900,
        "mchOrderNo": "D1777260495104",
        "orderState": 1,
        "originalAccountNumber": "03123451231",
        "payData": "00020101021238530010A0000007270123000697043101091003496170208QRIBFTTA53037045407200,0005802VN62120808LQSMT6YT630467E7",
        "payDataType": "payurl",
        "payOrderId": "P439266522884476929",
        "payUrl": "https://checkout-test-vn.tpservice.vip/#/pay/P439266522884476929",
        "payWays": {
            "qr": [
                {
                    "countryCode": "vn",
                    "createdAt": 0,
                    "id": 80,
                    "payCode": "00020101021238530010A0000007270123000697043101091003496170208QRIBFTTA53037045407200,0005802VN62120808LQSMT6YT630467E7",
                    "payWay": "QR",
                    "payWayLogo": "https://defipay.oss-ap-southeast-1.aliyuncs.com/tarspay_v_1.0/QR.png",
                    "payWayType": "qr",
                    "skipMode": 1,
                    "state": 1,
                    "updatedAt": 0
                }
            ]
        },
        "reference": "LQSMT6YT",
        "requestUrl": "https://checkout.lioneasy.com/callback",
        "subject": "test",
        "typeBank": "EXIMBANK"
    },
    "msg": "SUCCESS",
    "sign": ""
}

Modified at 2026-05-20 09:20:41

Attachment Code Table

Query deposit order status