Create a deposit order

POST

/api/pay/unifiedOrder

Collection Method Categories and Return Values from the Collection Order API

Collection Method Categories	Return Value Description
Bank VA Class Bank VA	payData: Bank's VA number. Merchants must create their own payment details page. payUrl: TarsPay's VA payment details page

Notes:

payData is the payee's account number. The core payment data uses the value returned by the API.

accountName is the payee's name.

typeBank is the receiving bank.

VA Type Code

wayCode	Name
va	va

Limit Information

	Collection Amount Rules
Collection Channel	Minimum Single Transaction	Maximum Single Transaction
va	10,000	9,000,000

Request

Header Params

Body Params application/json

Example

{
    "amount": "10000",
    "mchOrderNo": "D1755682397860",
    "wayCode": "va",
    "customerName": "홍길동",
    "notifyUrl": "https://www.baidu.com",
    "currency": "KRW",
    "returnUrl": "https://payment.tarspay.com/api/notify/jazzcash",
    "mchNo": "M1754904085"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/pay/unifiedOrder' \
--header 'X-API-KEY: 02106af2a085fbfc6d1bb49f485205fcdfcc79a4ddb1913c72a271fedd24c2d7fe' \
--header 'X-API-NONCE: 1702279880267' \
--header 'X-API-SIGNATURE: 304502207a4a88a5b0def29b9dbbf8563112d090c0e0b793ff6a5c57fe9d4fd1254d8ecf022100ff63c279f5926069fa1d161598e8d3249cb90e9d728e88e514352cdae6feff72' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": "10000",
    "mchOrderNo": "D1755682397860",
    "wayCode": "va",
    "customerName": "홍길동",
    "notifyUrl": "https://www.baidu.com",
    "currency": "KRW",
    "returnUrl": "https://payment.tarspay.com/api/notify/jazzcash",
    "mchNo": "M1754904085"
}'

Responses

🟢200成功

application/json

Body

Examples

Bank VA Success ExamplesE-wallet success examplesQRIS Success Examples

{
    "code": 0,
    "data": {
        "accountName": "홍길동 test",
        "amount": "10000",
        "body": "test",
        "countryCode": "kr",
        "currency": "KRW",
        "customerContact": "03014055050",
        "expiredTime": 1755682999,
        "mchOrderNo": "D1755682397860",
        "orderState": 1,
        "payData": "1234578494",
        "payDataType": "payurl",
        "payOrderId": "P348761407707156481",
        "payUrl": "https://kr-test.tpservice.vip/#/pay/P348761407707156481",
        "payWays": {
            "bank": [
                {
                    "countryCode": "kr",
                    "createdAt": 0,
                    "id": 163,
                    "payCode": "1234578494",
                    "payWay": "va",
                    "payWayLogo": "https://defipay.oss-ap-southeast-1.aliyuncs.com/Mask%20group.png",
                    "payWayType": "bank",
                    "skipMode": 1,
                    "state": 1,
                    "updatedAt": 0
                }
            ]
        },
        "requestUrl": "https://payment.tarspay.com/api/notify/jazzcash",
        "subject": "test",
        "typeBank": "국민은행"
    },
    "msg": "SUCCESS",
    "sign": ""
}

Modified at 2025-08-20 11:18:29

Attachment Code Table

Query deposit order status

Create a deposit order

Collection Method Categories and Return Values from the Collection Order API#

Notes:#

VA Type Code#