Simulate Payout

PATCH

/api/v1/payout/simulate-payout

This API is used to simulate the completion of a Payout that has been created.

The Payout must be in a PENDING status to complete it. Upon successful execution, the Payout status updates to COMPLETED, FAILED orRETURNED. If the Payout is not in a PENDING status, 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

{
    "payout_id": "24cc76a6-4433-443c-9c0f-3607c294c32e",
    "status": "COMPLETED",
    "beneficiary_amount": 13.7,
    "beneficiary_currency": "NZD"
}

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/payout/simulate-payout' \
--header 'X-token: snd_eyJpdiI6Iis5U1draFVQZWpZbE1pSlZ2VGdNM2c9PSIsInZhbHVlIjoia3VOTzhGZFk1Zk9ydnhqeTJFME56ZjkzWnE0SW5ZOURCZ0t0NG8xNFI4dWtyLzVZeWJrc1Z5MW1NdVl5SzlSQyIsIm1hYyI6ImJhZDJkZTIwMDdmYTU4N2MzMGVjY2YxYzZlYmE2YTNlOTc2ODQ4MjYwMTJiMDIwZWQzYWU1OTA0MDRlNDJmZDIiLCJ0YWciOiIifQ==' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payout_id": "24cc76a6-4433-443c-9c0f-3607c294c32e",
    "status": "COMPLETED",
    "beneficiary_amount": 13.7,
    "beneficiary_currency": "NZD"
}'

Responses

🟢200Success

application/json

Body

Example

{
  "status": true,
  "message": "OK",
  "data": {
    "id": "edc1f92c-12c2-4b80-bf32-c24dcc0dfa1e",
    "merchant_id": "2a776a4a-ad24-4ccb-80ce-fd58bd0e5880",
    "reply_code_id_pg": "payout_9d84899053d44777b0d53345353ffa98",
    "status": "COMPLETED",
    "wire_id": "w_txn_95d18bef65d74d179e78a2902c8d6723",
    "order_id": null,
    "due_date": "2025-02-25T00:00:00.000Z",
    "last_action": null,
    "wire_amount": 97,
    "fee_taken": 1.94,
    "fee_expected": 3,
    "payee_name": "Fajar test",
    "currency": "AUD",
    "beneficiary": "Fajar test",
    "beneficiary_bank": "au_bank_acct",
    "beneficiary_account_number": null,
    "beneficiary_account_iban": null,
    "wire_origin": null,
    "conversion": null,
    "approval": "APPROVED",
    "created_at": "2025-02-24T01:56:32.000Z",
    "updated_at": "2025-02-24T02:00:29.000Z",
    "approved_at": null,
    "denied_at": null,
    "pending_at": null
  }
}

🟠404Record Not Found

🟠400Bad Request

Modified at 2025-08-19 07:00:39

Create Payout

Retrieve Payout