TarsPay_EN
  1. withdraw
TarsPay_EN
Korea🇰🇷
  • Indonesia🇮🇩
  • India🇮🇳
  • Thailand🇹🇭
  • Philippines🇵🇭
  • Malaysia🇲🇾
  • Vietnam🇻🇳
  • Egypt🇪🇬
  • Bangladesh🇧🇩
  • Kenya🇰🇪
  • Pakistan🇵🇰
  • Brazil🇧🇷
  • Mexico🇲🇽
  • Korea🇰🇷
  • Türkiye🇹🇷
  • Access Guide
  • Core Business Process Description
  • Attachment Code Table
  • deposit
    • Create a deposit order
      POST
    • Query deposit order status
      POST
  • withdraw
    • Create withdraw order
      POST
    • Query withdraw order
      POST
  • account
    • Query balance
      POST
  • CallBack
    • Callback notification interface (customized by the merchant)
      POST
  1. withdraw

Create withdraw order

POST
/api/payOut/unifiedOrder

Payment Bank Code#

wayCodeFull English NameChinese TranslationKorean Name
BOKBank of KoreaBank of Korea (South Korea's central bank)한국은행
KBKB Kookmin BankKB Kookmin BankKB국민은행
Woori BankWoori BankWoori Bank우리은행
SCFBSC First BankSC First BankSC제일은행
Citi KoreaCitibank KoreaCitibank Korea한국씨티은행
iM BankiM BankiM Bank (formerly Small and Medium Enterprise Bank)iM뱅크
Hana BankHana BankHana Bank하나은행
Shinhan BankShinhan BankShinhan Bank신한은행
K BankK BankK Bank (Internet Bank in Korea)케이뱅크
Kakao BankKakao BankKakao Bank (Internet Bank in Korea)카카오뱅크
Toss BankToss BankToss Bank (Internet Bank in Korea)토스뱅크
Suhyup BankSuhyup BankSuhyup Bank (Fisheries Cooperative Bank)수협은행
NH BankNH Nonghyup BankNH Nonghyup BankNH농협은행
Busan BankBusan BankPusan Bank (Regional Bank)부산은행
Gyeongnam BankGyeongnam BankGyeongnam Bank (Regional Bank)경남은행
Gwangju BankGwangju BankGwangju Bank (Regional Bank)광주은행
Jeonbuk BankJeonbuk BankJeonbuk Bank (Regional Bank)전북은행
Jeju BankJeju BankJeju Bank (Regional Bank)제주은행
NACFNational Agricultural Cooperative FederationNonghyup (Agricultural Cooperative)농협
KFCKorea Forestry CooperativesSanlin Cooperative (Forestry Cooperative)산림조합
SMGSaemaeul GeumgoSaemaeong-ryong Bank (Grassroots Financial Institution)새마을금고
Credit Co-opsCredit CooperativesCredit Cooperatives (Credit Cooperatives)신협

Limit Information#

Payment Amount Rules
Payment ChannelMinimum Single TransactionMaximum Single Transaction
BANK10,0002,000,000
EWALLET10,00025,000,000

Request

Header Params

Body Params application/json

Example
{
    "amount": "10000.00",
    "customerContact": "0301322239",
    "mchOrderNo": "D1755683313829",
    "customerEmail": "g762646676@126.com",
    "wayCode": "KFC",
    "notifyUrl": "https://***",
    "currency": "KRW",
    "customerAccountNumber": "12345678911112",
    "mchNo": "M1754904085",
    "customerName": "한국"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/payOut/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.00",
    "customerContact": "0301322239",
    "mchOrderNo": "D1755683313829",
    "customerEmail": "g762646676@126.com",
    "wayCode": "KFC",
    "notifyUrl": "https://***",
    "currency": "KRW",
    "customerAccountNumber": "12345678911112",
    "mchNo": "M1754904085",
    "customerName": "한국"
}'

Responses

🟢200成功
application/json
Body

Example
{
    "code": 0,
    "data": {
        "mchOrderNo": "M1655535407",
        "payOrderId": "P1551409540398772225"
    },
    "msg": "SUCCESS"
}
Modified at 2025-08-20 11:22:23
Previous
Query deposit order status
Next
Query withdraw order
Built with