API Documentation
  1. Payin
API Documentation
  • API Documentation Change Log
  • API Reference Guide
    • Checkout Page
    • Payin - KRW (Server to Server)
    • Purpose Code
    • Payout Payload Example
    • List of Payin Methods
    • List of Bank for Payout Methods
  • API Documentation
    • Master Data
      • Get All Country & Currency Code
    • Payout Method
      • Get All Payout Method
    • Payin Method
      • Get All Payin Method
      • Get Required Fields by Payin method
    • Payin
      • Create Payin
        POST
      • Simulate Payin
        PATCH
      • Retrieve Payin
        GET
      • Create Virtual Account
        POST
    • Payout
      • Create Payout
      • Simulate Payout
      • Retrieve Payout
      • Get All Payout
    • Checkout
      • Create Payment Request
      • Get All Checkout
      • Get Detail Checkout
      • Create Virtual Account [KRW]
      • Get VA Bank Information [KRW]
      • Create New Checkout
    • Customer
      • Create Customer
      • Update Customer
      • Get All Customer
      • Get Detail Customer by Id
      • Check Is Customer Wallet Ready
      • Enable Customer
      • Disable Customer
      • Delete Customer
    • Webhook
      • Webhook PAYIN SUCCESS
      • Webhook PAYOUT SUCCESS
      • Webhook PAYOUT FAILED
      • VA Register Callback
      • Webhook PAYIN EXPIRED
    • Merchant
      • Get Balance Payout
    • Get List Payment Method by Currency
      GET
  • Features Documentation
    • Dashboard
    • Transaction
      • Payin
      • Payout
      • Rolling Reserve
      • Refund Request
    • Finance
      • Settlement Report APM
      • Settlement Report CARD
      • History Balance APM
      • History Balance CARD
    • Account
      • Profile Account
      • Manage Users
    • Setting
      • Integration Details
  1. Payin

Create Payin

POST
/api/v1/payin/create
This API is used to Create Payin. Payin is the primary Method for collecting funds from customers and depositing them into either the customer wallet or the Merchant's Payin wallet.
To successfully perform a Payin, the following APIs are required:
1.
Get All Payin Method
2.
Get Required Fields by Payin method
3.
Create Payin
4.
Simulate Payin
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');

Additional Step for KRW Currency#

When creating a Payin with KRW (Korean Won) as the currency, an additional process is required before calling the standard Create Payin API. This is because KRW transactions use the Virtual Account (VA) method, which requires pre-registration of the account details before initiating the payment request.
Below is the step-by-step process for KRW Payin (Server to Server):
1.
Get All Payin Method
2.
Create Virtual Account
3.
VA Registration Callback
4.
Create Payin
Note:
The complete documentation using KRW currency can be found here: Payin - KRW (Server to Server).

Request

Header Params

Body Params application/json

Example
{
    "amount": 565,
    "currency": "PHP",
    "payin_method_name": "ph_ewallet_paymaya_php",
    "payin_method_param": {
        "payid_reference": "invoice_19082025_001123"
    },
    "payment_method": "ph_ewallet_paymaya_php",
    "transaction": "invoice_19082025_001123",
    "transaction_date": "2025-08-19T13:18:09.478Z",
    "order_reference": "invoice_19082025_001123",
    "customer_full_name": "Fajar PH",
    "reply_code": "1234",
    "brand": "Blackpink",
    "credit_type": "PAYIN",
    "payer_id": "256699df-721c-48b5-84ed-bf794b87173b",
    "recon_id": "invoice_19082025_001123",
    "order_reference_1": "invoice_19082025_001123",
    "order_reference_2": "invoice_19082025_001123",
    "platform_identifier": "invoice_19082025_001123",
    "customer_id": "customer_350635a488994af081ee67d57fc07322",
    "billing_address_country": "PH",
    "trx_type": "DIRECT_PAYIN",
    "customer_email": "testblacklistqa33@yopmail.com",
    "customer_phone": "+6285156781122",
    "charge_back": 0,
    "retrieval": 0,
    "is_black_list": 0
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.paycombat.com/api/v1/payin/create' \
--header 'X-token: snd_eyJpdiI6InkrQW9PNnpqc1JpTk02aVprYnl3b3c9PSIsInZhbHVlIjoiQ0I4YWFTSks3WnZjaTYrNUFrSVVTNG5mMG44cHlFblljLzB5ZkpzVDh3UTFYZUIxZlFsMHhNYm1KZFFzNUpSMiIsIm1hYyI6IjMzNjM0MDE4YTA0ZmJkNGVjNjJhMWY5N2EyMjJlYTE3YTI0YjdkM2MwNzkyMGQzNzdiYzA0NzE4M2U0MzA2MTMiLCJ0YWciOiIifQ==' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 565,
    "currency": "PHP",
    "payin_method_name": "ph_ewallet_paymaya_php",
    "payin_method_param": {
        "payid_reference": "invoice_19082025_001123"
    },
    "payment_method": "ph_ewallet_paymaya_php",
    "transaction": "invoice_19082025_001123",
    "transaction_date": "2025-08-19T13:18:09.478Z",
    "order_reference": "invoice_19082025_001123",
    "customer_full_name": "Fajar PH",
    "reply_code": "1234",
    "brand": "Blackpink",
    "credit_type": "PAYIN",
    "payer_id": "256699df-721c-48b5-84ed-bf794b87173b",
    "recon_id": "invoice_19082025_001123",
    "order_reference_1": "invoice_19082025_001123",
    "order_reference_2": "invoice_19082025_001123",
    "platform_identifier": "invoice_19082025_001123",
    "customer_id": "customer_350635a488994af081ee67d57fc07322",
    "billing_address_country": "PH",
    "trx_type": "DIRECT_PAYIN",
    "customer_email": "testblacklistqa33@yopmail.com",
    "customer_phone": "+6285156781122",
    "charge_back": 0,
    "retrieval": 0,
    "is_black_list": 0
}'

Responses

🟢200OK
application/json
Body

Example
{
  "status": true,
  "message": "OK",
  "data": {
    "id": "c2fe7846-494f-4852-8ca2-a72499d0002e",
    "merchant_id": "5dc46f8a-4924-4392-967b-81652396a175",
    "reply_code_id_pg": "payin_b9b9b3dd72da4c9fa64c197129dbbacd",
    "status": "PENDING",
    "amount": "97",
    "original_amount": "100",
    "amount_type": "AUD",
    "transaction": "invoice_06032025_002",
    "transaction_date": "2024-03-06T13:18:09.000Z",
    "payment_method": "au_bank_npp",
    "order_reference": "invoice_06032025_002",
    "customer_full_name": "Lalisa Manobal",
    "reply_code": "invoice_06032025_002@paycombat.com",
    "brand": "Blackpink",
    "currency": "FIAT",
    "credit_type": "PAYIN",
    "payer_id": "invoice_06032025_002",
    "recon_id": "invoice_06032025_002",
    "order_reference_1": "invoice_06032025_002",
    "order_reference_2": "invoice_06032025_002",
    "platform_identifier": "invoice_06032025_002",
    "trx_type": "DIRECT_PAYIN",
    "customer_email": "lalisamanobal@gmail.com",
    "customer_phone": "+6285156781122",
    "customer_personal_number": "",
    "fee_taken": "3",
    "fee_expected": "3",
    "charge_back": "0",
    "rolling_serve": "0",
    "retrieval": "0",
    "is_black_list": 0,
    "ip_address": "",
    "billing_address_country": "AU",
    "billing_address_city": "",
    "billing_address_zip_code": "",
    "billing_address": "",
    "bin": "",
    "is_3ds": "",
    "created_at": "2025-03-06T05:45:22.000Z",
    "updated_at": "2025-03-06T05:45:22.000Z",
    "deleted_at": null,
    "payment_date": null
  }
}
🟠400Bad Request
Modified at 2025-08-19 05:30:14
Previous
Get Required Fields by Payin method
Next
Simulate Payin