Simulate Payin

Developing

PATCH

/api/v1/payin/simulate-payin

This API is used to simulate the completion or cancellation of a Payin that has been created.

The Payin must be in a PENDING status to complete or cancel it. Upon successful execution, the Payin status updates to COMPLETED or CANCELLED. If the Payin is not in a PENDING status or if you attempt to complete an already completed or cancelled Payin, an error will be returned.

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

{
    "payin_id": "3f034d03-802b-41e1-aeb5-b4b80241133f",
    "status": "COMPLETED",
    "amount": 67,
    "currency": "PHP"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://api.paycombat.com/api/v1/payin/simulate-payin' \
--header 'X-token: snd_eyJpdiI6InkrQW9PNnpqc1JpTk02aVprYnl3b3c9PSIsInZhbHVlIjoiQ0I4YWFTSks3WnZjaTYrNUFrSVVTNG5mMG44cHlFblljLzB5ZkpzVDh3UTFYZUIxZlFsMHhNYm1KZFFzNUpSMiIsIm1hYyI6IjMzNjM0MDE4YTA0ZmJkNGVjNjJhMWY5N2EyMjJlYTE3YTI0YjdkM2MwNzkyMGQzNzdiYzA0NzE4M2U0MzA2MTMiLCJ0YWciOiIifQ==' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payin_id": "3f034d03-802b-41e1-aeb5-b4b80241133f",
    "status": "COMPLETED",
    "amount": 67,
    "currency": "PHP"
}'

Responses

🟢200Success

application/json

Body

Examples

SuccessSuccess

{
  "status": true,
  "message": "OK",
  "data": {
    "id": "b442ba6c-74cb-4a5b-a921-33dabb77c25e",
    "merchant_id": "2c23d9af-d8b5-42fd-ae4b-cf9b111f4e55",
    "reply_code_id_pg": "payin_dd2962af112545d492a98486d875e81e",
    "status": "SUCCESS",
    "amount": "9.9",
    "original_amount": "10",
    "amount_type": "AUD",
    "transaction": "invoice_20022025_222",
    "transaction_date": "2025-02-28T13:18:09.000Z",
    "payment_method": "au_bank_npp",
    "order_reference": "invoice_28022025_222",
    "customer_full_name": "Leonardo 2 Jumat",
    "reply_code": "invoice_28022025_222@paycombat.com",
    "brand": "Blackpink",
    "currency": "FIAT",
    "credit_type": "PAYIN",
    "payer_id": "invoice_29122024_098",
    "recon_id": "string",
    "order_reference_1": "invoice_28022025_222",
    "order_reference_2": "invoice_28022025_222",
    "platform_identifier": "invoice_28022025_222",
    "trx_type": "DIRECT_PAYIN",
    "customer_email": "leonardo22@yopmail.com",
    "customer_phone": "+6285156781122",
    "customer_personal_number": "",
    "fee_taken": "0.1",
    "fee_expected": "0.1",
    "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-02-28T04:36:40.000Z",
    "updated_at": "2025-02-28T08:54:27.000Z",
    "deleted_at": null,
    "payment_date": null
  }
}

🟠400Bad Request

Modified at 2025-08-19 05:32:41

Create Payin

Retrieve Payin