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>", "bankCode": "<string>", "accountNo": "<string>", "name": "<string>", "phone": "<string>", "email": "jsmith@example.com", "partnerUserId": "<string>", "sign": "<string>", "notifyUrl": "<string>", "subject": "<string>", "body": "<string>" } '

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

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

Show child attributes

​Secret Key & Private Key (Generate Signature)

​Related Topics

Body

Response

Secret Key & Private Key (Generate Signature)

Related Topics