Create Virtual Account [KRW] - API Documentation

Checkout simplifies the process of creating an optimal payment experience:

Designed to minimize friction

Supports multiple global payment methods

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

optional

Example:

snd_eyJpdiI6InZrYXozdnh0Ly9BOE9kZ2xHQ2RQUFE9PSIsInZhbHVlIjoidnhZWXlOdmtiVDM4VC9hU0dBUTI5VWNockNaNHJHMDRBSEtpR09ja05PaFFpUk0rYkl3bHhzT0lWTC9zY2ZqWiIsIm1hYyI6IjExMTZhNGFiYjU5MDU2NTQ5MTE2NWQ1NjM4YWRiYTIxZWIwZDNjY2E4NWU5ZjFkMTkyYjQ3NGY2ZGQzMDI4ZWEiLCJ0YWciOiIifQ==

signature

string

optional

Body Params application/json

checkout_token

string

required

payin_method_name

string

required

Example

{
  "checkout_token": "4ba3ff49375e7fff33f9c5b5ce7155798ab3b397db97667d8d6381b1b6a9229a",
  "payin_method_name": "KDB산업은행"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

status

boolean

required

message

string

required

data

object

required

string

required

checkout_token

string

required

amount

integer

required

currency

string

required

country_code

string

required

country_name

string

required

payin_method_name

string

required

payin_type

null

required

description

string

required

merchant_id

string

required

customer_id

null

required

redirect_url

string

required

webhook_url

string

required

advanced_redirect_url

null

required

expire_at

string

required

additional_info

object

required

status

string

required

created_at

string

required

updated_at

string

required

deleted_at

null

required

user_yymmdd

string

required

account_bank

string

required

Example

{
    "status": true,
    "message": "OK",
    "data": {
        "id": "34ea2096-ab18-403b-8f86-fca06eeea3f0",
        "checkout_token": "b8cb8429b02c1c66955cf194ac232553b5f646a99024ae1f08e0335f16476ec2",
        "amount": 100,
        "currency": "KRW",
        "country_code": "KR",
        "country_name": "South Korea",
        "payin_method_name": "KDB산업은행",
        "payin_type": null,
        "description": "invoice_28052025_008",
        "merchant_id": "ea78f82a-9434-43b0-a44b-9ef7b1b2c11a",
        "customer_id": null,
        "redirect_url": "https://staging-checkout.paycombat.dev/?token=ba8a36b3468a3b609a707ad1e1835af3%3Adc47f530ad1068eed081ab20a6f407b5fa8cb4ac55c9cf046b8718787d7f26a5577421529fba6ff2c3347f1a998e86fe38b441e344aee972c4652da4c1137a01728cec55e209de5a8882e1f6f1616d85058d87c09285fad0d0df8d7aa15d39377ce3ee3f122ec731e60d0a5b647ba49c965c3fdde9f8386af8815d6180b2534bb3b469b3c20b697855bced473abeabdfd75d774d3aca32aa5d0a705c7026e31f1bd9551c98e8b774a62ea4c545dcb76d35d091c90316a54ad9981898a201c70bf342d6f789c135c07263625f6ce39274f5f5cac0bc4a3637904c7e3728ba4e830ff67b98384107dfdc96c1bab40faf3e6a056698e00ba6402d6d3191755c0a1aac4be719ee5aab081ea7109c51c045c611d1ed9fd9a94a8d39615696c3d7e383d19e45d422ee57d7d7b09b5f3297e75b7e2290dbdb75710c6f900a7a411890bffeb6dbd9803d194f8eb7c026faa81cdf9d8d4d5bb816e6e4deee3887af84fea3ca72ede5cd57d2d96dba46ff000c2edd",
        "webhook_url": "https://staging-core.paycombat.dev/api/v1/external-api/webhook-notification/production/paycombat",
        "advanced_redirect_url": null,
        "expire_at": "2025-05-28T04:44:29.000Z",
        "additional_info": {
            "payid_reference": "invoice_28052025_008",
            "transaction": "invoice_28052025_008",
            "transaction_date": "2025-05-28T02:59:39.611Z",
            "order_reference": "invoice_28052025_008",
            "customer_full_name": "LALISA MANOBAL",
            "customer_email": "lalisamanobal@gmail.com",
            "customer_phone": "+6285156781122",
            "brand": "BLACKPINK",
            "credit_type": "CHECKOUT",
            "payer_id": "payer_id",
            "recon_id": "recon_id",
            "order_reference_1": "invoice_28052025_008",
            "order_reference_2": "invoice_28052025_008",
            "platform_identifier": "PAYCOMBAT",
            "trx_type": "CHECKOUT",
            "charge_back": 0,
            "retrieval": 0,
            "billing_address_country": "KR",
            "additional_info": {
                "account_number": "112233445"
            }
        },
        "status": "PENDING",
        "created_at": "2025-05-28T03:44:29.000Z",
        "updated_at": "2025-05-28T03:44:40.000Z",
        "deleted_at": null,
        "user_yymmdd": "105466",
        "account_bank": "KDB산업은행"
    }
}

🟠400Bad Request