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

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

Examples

ALL CurrencyTHB PromptpayIDRMYR FPX

{
  "amount": 1001,
  "currency": "TRY",
  "payin_method_name": "ty_bank_transfer_try",
  "payin_method_param": {
    "payid_reference": "REF-1788849770461-8376"
  },
  "payment_method": "ty_bank_transfer_try",
  "transaction": "REF-1788849770461-8376",
  "transaction_date": "2026-01-14T06:18:09.478Z",
  "order_reference": "REF-1788849770461-8374",
  "customer_full_name": "qa test",
  "reply_code": "1234",
  "brand": "Blackpink",
  "credit_type": "PAYIN",
  "payer_id": "256699df-721c-48b5-84ed-bf794b87173b",
  "recon_id": "invoice_10122025_740005",
  "order_reference_1": "invoice_10122025_740005",
  "order_reference_2": "invoice_10122025_740005",
  "platform_identifier": "invoice_10122025_740005",
  "customer_id": "customer_350635",
  "billing_address_country": "TR",
  "trx_type": "DIRECT_PAYIN",
  "customer_email": "qatest01@yopmail.com",
  "customer_phone": "01812345661",
  "charge_back": 0,
  "retrieval": 0,
  "is_black_list": 0,
  "description": "halo"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

ALL CurrencyTHB PromptpayIDRMYR FPX

curl --location 'https://api.paycombat.com/api/v1/payin/create' \
--header 'X-token: snd_eyJpdiI6IjVxMnpmNURCS1NWRXFFRSthT21DUVE9PSIsInZhbHVlIjoidjBWQUZWdm9zbEhxd3hvZjVuaFBoT0hwazhuei92OE55cis4TEg3TjJxT3o3TUdPMXYrY21tajBROHhpRFJNMSIsIm1hYyI6IjBkZTc1MjY5MjBkYzA1OTA3NWZmZTNkOWFjMGViZjI1NDNlNDUwNDI0MTA5MGYzYmYzOGI1MjY3N2ZkZTRiZjAiLCJ0YWciOiIifQ==' \
--header 'signature: snd_ZFuQH9DDOEedaje3iY44hwFDb6x74WSy' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 1001,
  "currency": "TRY",
  "payin_method_name": "ty_bank_transfer_try",
  "payin_method_param": {
    "payid_reference": "REF-1788849770461-8376"
  },
  "payment_method": "ty_bank_transfer_try",
  "transaction": "REF-1788849770461-8376",
  "transaction_date": "2026-01-14T06:18:09.478Z",
  "order_reference": "REF-1788849770461-8374",
  "customer_full_name": "qa test",
  "reply_code": "1234",
  "brand": "Blackpink",
  "credit_type": "PAYIN",
  "payer_id": "256699df-721c-48b5-84ed-bf794b87173b",
  "recon_id": "invoice_10122025_740005",
  "order_reference_1": "invoice_10122025_740005",
  "order_reference_2": "invoice_10122025_740005",
  "platform_identifier": "invoice_10122025_740005",
  "customer_id": "customer_350635",
  "billing_address_country": "TR",
  "trx_type": "DIRECT_PAYIN",
  "customer_email": "qatest01@yopmail.com",
  "customer_phone": "01812345661",
  "charge_back": 0,
  "retrieval": 0,
  "is_black_list": 0,
  "description": "halo"
}'

Responses

🟢200OK

application/json

Bodyapplication/json

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-09-11 06:02:09

Get All Payin Method

Simulate Payin