Create Virtual Account

POST

/api/v1/payin/create-va

This API is used to create a Virtual Account before initiating a Payin using KRW currency. A Payin is the primary method for collecting funds from customers. In this API, you need to provide a valid bank account when working in the production environment. You can refer to this page for the KRW Payin flow Payin - KRW (Server to Server).

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

Body Params application/json

Example

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

Request Code 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_eyJpdiI6IlNWL3c4Smhadko4dFg5azdldVN5ZXc9PSIsInZhbHVlIjoiVVlLaWxPS3ZXT3huNzJRdm00TmtOMmx2MEpocDlLdFRtcjRtWjRmdUdxK1FoQ243KzhTVkFqalFnMUNGRW5YVyIsIm1hYyI6ImUzZmRjOWFmOGE5NjdkOGNjYTJkZTkzMmJlMmI1YmZlNTIxOWFhNzA0NDM1NWYwNmVhNjg2ZjIzNmJkZmMwMTAiLCJ0YWciOiIifQ==' \
--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": 202,
    "country": "South Korea",
    "user_yymmdd": "270817"
}'

Responses

🟢200Success

application/json

Body

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": "270817",
    "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

Modified at 2025-09-16 01:24:04

Retrieve Payin

Simulate Create VA