Create withdraw order

withdraw bank code

bank & e-wallet code	bank & e-wallet name
MOMO	MOMO
VCB	VIETCOMBANK
VTB	VIETINBANK
TCB	TECHCOMBANK
BIDV	BIDV
SHB	SHB
DAB	DONGABANK
ACB	ACB
TPB	TPBANK
EXB	EXIMBANK
SAC	SACOMBANK
SCB	SCB
MBB	MBBANK
VIB	VIB
AGB	AGRIBANK
HDB	HDB
VPB	VPBANK
OEB	OCEANBANK
MSB	MSB
LPB	LPB
ABB	ABBANK
NCB	NCB
SEAB	SEABANK
PCV	PVCOMBANK
KLB	KIENLONGBANK
VCTB	VIETCAPITAL BANK
OCB	OCB
VEB	VIETBANK
VRB	VRB
SHV	SHBVN
UOB	Ngân hàng TNHH MTV United Overseas Bank (Việt Nam)
WOO	Ngân hàng TNHH Woori bank
HLB	Ngân hàng TNHH một thành viên Hong Leong Việt Nam
PBVN	Ngân hàng TNHH MTV PUBLIC Việt Nam
BVB	Ngân hàng TMCP Bảo Việt
IVB	Ngân hàng TNHH Indovina
PGB	Ngân hàng TNHH MTV Xăng dầu Petrolimex
NAB	Ngân hàng TMCP NAM Á（NAMABANK）
VAB	Ngân hàng TMCP Việt Á
SVB	Ngân hàng TNHH MTV Shinhan (Việt Nam)
GPB	Ngân hàng TNHH MTV Dầu khí toàn cầu
SGB	Ngân hàng Sài Gòn Công Thương

Limit information

	withdraw amount rules
withdraw channel	lowest single transaction	highest single transaction
BANK	200,000	100,000,000
EWALLET	200,000	100,000,000

Request

Header Params

X-API-KEY

string

required

The public key applied by the merchant backend

Example:

02d6433f5bedc5bc35b0971b8acce048b2ad4bce74210bea1288a10f42b166e057

X-API-NONCE

string

required

System timestamp accurate to milliseconds

Example:

1704248227906

X-API-SIGNATURE

string

required

signature

Example:

3045022100bac479cd032b4a39673b5419f204e47bddb78f0ef9e58117dca0160497c3b7730220650c6adde3f911f78d1c4f18cd4764ce9d64d1f5d0801ea2cb49d1a6deb8ea44

Body Params application/json

mchNo

string

Merchant No.

required

mchOrderNo

string

Merchant Order No. (guaranteed to be unique)

required

wayCode

string

withdraw code

required

withdraw code

currency

string

Currency

required

Fixed VND

amount

string

Amount

required

notifyUrl

string

Result notification address

required

customerName

string

User name

required

customerEmail

string

User mailbox

required

customerContact

string | null

User mobile phone

optional

Mobile phone number, when wayCode is MOMO, it cannot be empty

customerAccountNumber

string | null

User payment account

optional

User bank card, when wayCode is not MOMO, it cannot be empty

Example

{
    "amount": "1000000",
    "bankName": "VCB",
    "currency": "VND",
    "customerAccountNumber": "55686666888811111",
    "customerContact": "0978216915",
    "customerEmail": "g762646676@126.com",
    "customerName": "GDW",
    "mchNo": "M1688454487",
    "mchOrderNo": "YN35320230300880",
    "notifyUrl": "http://47.241.33.220:8896/tarspay/notify",
    "wayCode": "MOMO"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

code

integer

required

data

object

required

mchOrderNo

string

Merchant order number

required

payOrderId

string

Platform order number

required

msg

string

required

Example

{
    "code": 0,
    "data": {
        "mchOrderNo": "YN35320230300880",
        "payOrderId": "P1742369451135565825"
    },
    "msg": "SUCCESS",
    "sign": "3045022100c0d4f194dbdcf67f8b7dab94b67e9f8afc7304f61d79a20d9907152adf60c67202203e1079c1a7e8afd12c3404bd083617a4c9b6efb807fa98c37593eb6397737d0e"
}

Create withdraw order

Limit information#

Request

Request samples

Responses

Limit information