Create Payment Request - API Documentation

First Step to Create a Checkout. You have to create payment request first to generate Checkout Url.

Currency & Country Code

Fill in the currency field so the checkout page can display payment methods according to the currency. And for all european countries please fill in country_code with “EU”.

Amount

Fill in the amount of the transaction to calculate the amount to be paid by the customer. The amount field must match the amount in the order_items and order_fees.

Advanced Redirection Url

You can set the redirect url in the Create Payment API request message in the Advanced_redirect_url based on each payment status cancelled_url, completed_url, expired_url, failed_url. If it's not used, the value can be Null.

Additional Info

You can insert new object in additional_info such as Customer Information, and Transaction Date.

Order_items & Order_fees

The order_items consists of product_name, quantity, dan unit_price. And the order_fees consists of fee_name and fee_amount. You can choose whether to fill or not order_items or order_fees.

Send Request

After fill in the required fields, you can send a request to the API and will get the checkout page in the checkout_url field.

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

{
  "amount": 444,
  "currency": "KRW",
  "country_code": "KR",
  "country_name": "South Korea",
  "description": "invoice_01092025_0000001",
  "advanced_redirect_url": {
    "cancelled_url": "https://paycombat.com/cancelled",
    "completed_url": "https://paycombat.com/completed",
    "expired_url": "https://paycombat.com/expired",
    "failed_url": "https://paycombat.com/failed"
  },
  "additional_info": {
    "payid_reference": "invoice_01092025_0000001",
    "transaction": "invoice_01092025_0000001",
    "transaction_date": "2025-09-01T02:59:39.611Z",
    "order_reference": "invoice_01092025_0000001",
    "customer_full_name": "Aji KRW",
    "customer_email": "ajikrw44@yopmail.com",
    "customer_phone": "+6285156781122",
    "brand": "JOHNDOEBRAND",
    "credit_type": "CHECKOUT",
    "payer_id": "2f872ec8-721d-40bd-a103-9e6a8db40dbb",
    "recon_id": "johndoe_recond_id",
    "order_reference_1": "invoice_01092025_0000001",
    "order_reference_2": "invoice_01092025_0000001",
    "platform_identifier": "PAYCOMBAT",
    "trx_type": "CHECKOUT",
    "charge_back": 0,
    "retrieval": 0,
    "billing_address_country": "KR",
    "additional_info": {
      "account_number": "11223344",
      "user_yymmdd": "270817"
    }
  },
  "order_items": [
    {
      "product_name": "Mouse Logitech",
      "quantity": 9,
      "unit_price": 10
    }
  ],
  "order_fees": [
    {
      "fee_name": "ADMIN FEES",
      "fee_amount": 10
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

{
    "status": true,
    "message": "OK",
    "data": {
        "id": "2a38bad1-5d20-4f19-8012-f5e7f4974296",
        "checkout_token": "59799c7baf089b6ddabc7c57fd7340ba9ed25c9d814e8328ab795b83e45d920d",
        "amount": 100,
        "currency": "KRW",
        "country_code": "KR",
        "payin_method_name": null,
        "payin_type": null,
        "customer_id": "customer_350635a488994af081ee67d57fc07322",
        "checkout_url": "https://staging-checkout.paycombat.dev/?token=59799c7baf089b6ddabc7c57fd7340ba9ed25c9d814e8328ab795b83e45d920d&identifier=snd_eyJpdiI6Im5MV29WS1NjZ1p4T0xVcHFINjlJR3c9PSIsInZhbHVlIjoiWXphYVpSN1YyazdGYllLdEY5ZFY5cTQ1N0tSRkkvZnRyak1UN1dyb0d3NjYrQ3duT08wT2RpNERRWnFpcUVhdCIsIm1hYyI6IjMzNzE5YWYzZjYzMzFjMDdhYTZiZjdmMDEwZDJiOTVjNmRlMzkzZmZkOWUyM2FmNTY1MzEyMWM4NDY0MTYzNWYiLCJ0YWciOiIifQ==",
        "advanced_redirect_url": {
            "cancelled_url": "https://paycombat.com/cancelled",
            "completed_url": "https://paycombat.com/completed",
            "expired_url": "https://paycombat.com/expired",
            "failed_url": "https://paycombat.com/failed"
        },
        "expire_at": "2025-04-01T15:48:37.000Z",
        "additional_info": {
            "payid_reference": "invoice_30032025_011",
            "transaction_date": "2025-03-30T02:59:39.611Z",
            "customer_full_name": "JOHN DOE",
            "customer_email": "johndoe@email.com",
            "customer_phone": "+6285156781122",
            "brand": "JOHNDOEBRAND",
            "payer_id": "johndoe_payer_id",
            "recon_id": "johndoe_recond_id",
            "trx_type": "CHECKOUT",
            "charge_back": 0,
            "retrieval": 0
        },
        "created_at": "2025-03-30T15:48:37.000Z",
        "updated_at": "2025-03-30T15:48:37.000Z",
        "deleted_at": null
    }
}

🟠400Bad Request