Create Virtual Account

POST

/api/v1/payin/create-va

This API is used to Create Virtual Account before Create Payin using KRW currency. Payin is the primary Method for collecting funds from customers and depositing them into either the customer wallet or the Merchant's Payin wallet.

Each POST/PATCH Request requires a Signature in the header, you can follow the following code to create the Signature:
const crypto = require('crypto');

const signature = crypto.createHmac('sha256', signatureKey)
  .update(JSON.stringify(data)).digest('hex');

Request

Header Params

X-token

string

required

Merchant Personal Access Token

Example:

snd_eyJpdiI6IlQxdlRpUGpIaWlyRHZGUUNsV0hMbUE9PSIsInZhbHVlIjoiUFBZTjlhMlhEWFcvTmJuc3hkWWtpbTBScVpDZUVjdVJ0TWMzUDhxMG9EMWFGVUZ0bGFtUzZNb1V6bHoxTTZoMiIsIm1hYyI6IjEzMjc2YTdhNWJhZDBmYWU0YzRiNzgwZTcwYjE3YmE0ZWNlMWI5YmNmOTU1OWZhOTliYzFjZTg5Yzk5MDk4NjEiLCJ0YWciOiIifQ==

signature

string

required

Hash your string payload request using SHA256, and use your SignatureKey as key

Body Params application/json

customer_full_name

string

required

payin_method_name

string

required

account_number

string

required

account_holder_name

string

required

currency

string

required

amount

integer

required

country

string

required

Example

{
  "customer_full_name": "Fajar P",
  "payin_method_name": "KDB산업은행",
  "account_number": "112233445",
  "account_holder_name": "Fajar P",
  "currency": "KRW",
  "amount": 128,
  "country": "South Korea"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.paycombat.com/api/v1/payin/create-va' \
--header 'X-token: snd_eyJpdiI6IlQxdlRpUGpIaWlyRHZGUUNsV0hMbUE9PSIsInZhbHVlIjoiUFBZTjlhMlhEWFcvTmJuc3hkWWtpbTBScVpDZUVjdVJ0TWMzUDhxMG9EMWFGVUZ0bGFtUzZNb1V6bHoxTTZoMiIsIm1hYyI6IjEzMjc2YTdhNWJhZDBmYWU0YzRiNzgwZTcwYjE3YmE0ZWNlMWI5YmNmOTU1OWZhOTliYzFjZTg5Yzk5MDk4NjEiLCJ0YWciOiIifQ==' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer_full_name": "Fajar P",
    "payin_method_name": "KDB산업은행",
    "account_number": "112233445",
    "account_holder_name": "Fajar P",
    "currency": "KRW",
    "amount": 128,
    "country": "South Korea"
}'

Responses

🟢200Success

application/json

Body

status

boolean

required

message

string

required

data

object

required

string

required

merchant_id

string

required

user_name

string

required

user_yymmdd

string

required

account_bankname

string

required

account_number

string

required

account_holder

string

required

status

string

required

created_at

string

required

updated_at

string

required

deleted_at

null

required

additional_info

null

required

Example

{
  "status": true,
  "message": "OK",
  "data": {
    "id": "c2fe7846-494f-4852-8ca2-a72499d0002e",
    "merchant_id": "5dc46f8a-4924-4392-967b-81652396a175",
    "user_name": "JOHN DOE",
    "user_yymmdd": "112233",
    "account_bankname": "KRW_BANK_NAME",
    "account_number": "112233445",
    "account_holder": "JOHN DOE",
    "status": "PENDING",
    "created_at": "2025-03-06T05:45:22.000Z",
    "updated_at": "2025-03-06T05:45:22.000Z",
    "deleted_at": null,
    "additional_info": null
  }
}

🟠400Bad Request

Retrieve Payin Memo (PDF)

Payout