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:

Get All Payin Method

Get Required Fields by Payin method

Create Payin

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');

Request

Header Params

Body Params application/json

Example

{
    "amount": 600,
    "currency": "IDR",
    "payin_method_name": "VA BSI",
    "payin_method_param": {
        "payid_reference": "invoice_28012026_0006"
    },
    "payment_method": "VA BSI",
    "transaction": "invoice_28012026_0006",
    "transaction_date": "2026-01-28T06:18:09.478Z",
    "order_reference": "invoice_28012026_0006",
    "customer_full_name": "Fjr IDR",
    "reply_code": "1234",
    "brand": "Blackpink",
    "credit_type": "PAYIN",
    "payer_id": "256699df-721c-48b5-84ed-bf794b87173b",
    "recon_id": "invoice_28012026_0006",
    "order_reference_1": "invoice_28012026_0006",
    "order_reference_2": "invoice_28012026_0006",
    "platform_identifier": "invoice_28012026_0006",
    "billing_address_country": "ID",
    "trx_type": "DIRECT_PAYIN",
    "customer_email": "depots588@yopmail.com",
    "customer_phone": "+6285156781122",
    "charge_back": 0,
    "retrieval": 0,
    "is_black_list": 0
}

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' \
--header 'X-token: snd_eyJpdiI6IlhtcEFvWGN4SHVqZzBtb0h2dUdhcmc9PSIsInZhbHVlIjoid1lzWFU0OHcvNUY5aEJ3bUpvV3QvMVlwYnEwOFVxTmxuYldpdStVdGRPNDdTT0JZRjA5b0EwY1gwQnovRW9kZiIsIm1hYyI6ImQxNTVhYWJhODk2YzkxM2YxZDNjMDhjM2RmM2ZmNTNmMTVmZGEwNmY0ZDEzYTk2Y2RmNDQ5NDVlNTU2MDBhZTkiLCJ0YWciOiIifQ==' \
--header 'signature: snd_eTS3udTYBye92b2epv1rYZzQAoCkPEc2' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 600,
    "currency": "IDR",
    "payin_method_name": "VA BSI",
    "payin_method_param": {
        "payid_reference": "invoice_28012026_0006"
    },
    "payment_method": "VA BSI",
    "transaction": "invoice_28012026_0006",
    "transaction_date": "2026-01-28T06:18:09.478Z",
    "order_reference": "invoice_28012026_0006",
    "customer_full_name": "Fjr IDR",
    "reply_code": "1234",
    "brand": "Blackpink",
    "credit_type": "PAYIN",
    "payer_id": "256699df-721c-48b5-84ed-bf794b87173b",
    "recon_id": "invoice_28012026_0006",
    "order_reference_1": "invoice_28012026_0006",
    "order_reference_2": "invoice_28012026_0006",
    "platform_identifier": "invoice_28012026_0006",
    "billing_address_country": "ID",
    "trx_type": "DIRECT_PAYIN",
    "customer_email": "depots588@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 2026-02-06 02:19:32

Get Required Fields by Payin method

Simulate Payin