Skip to main content
POST
/
krw
/
collect
/
apply
KRW Collection Application
curl --request POST \
  --url https://uat-interface.haipay.asia/krw/collect/apply \
  --header 'Content-Type: application/json' \
  --data '
{
  "appId": 123,
  "orderId": "<string>",
  "name": "<string>",
  "phone": "<string>",
  "email": "jsmith@example.com",
  "amount": "<string>",
  "payType": "<string>",
  "inBankCode": "<string>",
  "callBackUrl": "<string>",
  "callBackFailUrl": "<string>",
  "partnerUserId": "<string>",
  "sign": "<string>",
  "notifyUrl": "<string>",
  "subject": "<string>",
  "country": "<string>",
  "body": "<string>"
}
'
{
  "status": "<string>",
  "error": "<string>",
  "msg": "<string>",
  "data": {
    "orderId": "<string>",
    "orderNo": "<string>",
    "payUrl": "<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
name
string
required

User name, recommended to use real name, format: firstName and lastName separated by space, example: Donald John Trump

phone
string
required

Phone number

email
string<email>
required

Email address

amount
string
required

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

Pattern: ^\d+\.\d{2}$
payType
string
required
inBankCode
string
required
callBackUrl
string<uri>
required

URL to redirect after successful payment

callBackFailUrl
string<uri>
required

URL to redirect after failed payment

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

country
string

Cashier mode requires this parameter, please pass: 410

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