Skip to main content
POST
KRW Disbursement Application
All example requests on this page are based on the sandbox (test) environment. Please be careful to distinguish it from the production environment.

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 October 13, 2026