Skip to main content
POST
/
krw
/
pay
/
apply
KRW Disbursement Application
curl --request POST \
  --url https://uat-interface.haipay.asia/krw/pay/apply \
  --header 'Content-Type: application/json' \
  --data '
{
  "appId": 123,
  "orderId": "<string>",
  "amount": "<string>",
  "accountType": "BANK_ACCOUNT",
  "bankCode": "<string>",
  "accountNo": "<string>",
  "name": "<string>",
  "phone": "<string>",
  "email": "jsmith@example.com",
  "partnerUserId": "<string>",
  "sign": "<string>",
  "notifyUrl": "<string>",
  "subject": "<string>",
  "body": "<string>"
}
'
{
  "status": "<string>",
  "error": "<string>",
  "msg": "<string>",
  "data": {
    "orderId": "<string>",
    "orderNo": "<string>",
    "sign": "<string>"
  }
}

Secret Key & Private Key (Generate Signature)

Body

application/json
appId
integer
required

Business ID (obtained from backend, must pass corresponding business ID based on currency in URL)

orderId
string
required

Merchant order number

Maximum string length: 48
amount
string
required

Transaction amount (unit: ₩, accurate to two decimal places; do not add punctuation, e.g., ",")

Pattern: ^\d+\.\d{2}$
accountType
enum<string>
required

Account type: BANK_ACCOUNT (bank account)

Available options:
BANK_ACCOUNT
bankCode
string
required

Bank code (see Appendix: Payout Bank Codes)

accountNo
string
required

User bank account number

name
string
required

Recipient name (format: uppercase and lowercase letters with spaces allowed, 1-30 characters, "firstName middleName lastName" (middleName is optional, special characters supported: .-))

Required string length: 1 - 30
Pattern: ^[A-Za-z\s\'\-\.]+$
phone
string
required

Phone number

email
string<email>
required

Email address

partnerUserId
string
required

Unique user identifier (e.g., userId), used for risk control, must be real and valid, otherwise it will affect transactions. Format requirements: digits, uppercase and lowercase letters or common symbols -~!@#$%&*()_.

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
required

Signature

notifyUrl
string<uri>

Callback URL

subject
string

Payment remark

body
string

Remark details

Response

200 - application/json
status
string

1: Normal, 0: Exception

error
string

Error code

msg
string

Error description

data
object
Last modified on April 10, 2026