API Documentation
  1. Webhook
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
      • Simulate Payin
      • Retrieve Payin
      • Create Virtual Account
      • Simulate Create VA
    • 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
    • Webhook
      • Webhook PAYIN SUCCESS
        POST
      • Webhook PAYIN FAILED
        POST
      • Webhook PAYIN EXPIRED
        POST
      • Webhook PAYOUT SUCCESS
        POST
      • Webhook PAYOUT FAILED
        POST
      • VA Register Callback
        POST
    • 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. Webhook

Webhook PAYIN FAILED

Developing
POST
merchant_url_here
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
{
  "id": "e3e229ca-a38f-4af0-95a0-89732c815045",
  "merchant_id": "a1fe780b-94cb-4f6a-966c-ceefeb6ca3b0",
  "status": "FAILED",
  "wire_id": "w_txn_59376ed600464042b37e53625297fb00",
  "order_id": null,
  "due_date": "2025-05-16T00:00:00.000Z",
  "last_action": null,
  "original_amount": "31",
  "payee_name": "Fajar NZD",
  "currency": "NZD",
  "beneficiary": "Fajar NZD",
  "beneficiary_bank": "nz_bank_directcredit_nzd",
  "beneficiary_account_number": null,
  "beneficiary_account_iban": null,
  "wire_origin": null,
  "conversion": null,
  "approval": "FAILED",
  "created_at": "2025-05-15T04:15:38.000Z",
  "updated_at": "2025-05-15T04:16:08.000Z",
  "approved_at": null,
  "denied_at": null,
  "pending_at": null,
  "type": "PAYOUT"
}

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.commerchant_url_here' \
--header 'X-Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "e3e229ca-a38f-4af0-95a0-89732c815045",
  "merchant_id": "a1fe780b-94cb-4f6a-966c-ceefeb6ca3b0",
  "status": "FAILED",
  "wire_id": "w_txn_59376ed600464042b37e53625297fb00",
  "order_id": null,
  "due_date": "2025-05-16T00:00:00.000Z",
  "last_action": null,
  "original_amount": "31",
  "payee_name": "Fajar NZD",
  "currency": "NZD",
  "beneficiary": "Fajar NZD",
  "beneficiary_bank": "nz_bank_directcredit_nzd",
  "beneficiary_account_number": null,
  "beneficiary_account_iban": null,
  "wire_origin": null,
  "conversion": null,
  "approval": "FAILED",
  "created_at": "2025-05-15T04:15:38.000Z",
  "updated_at": "2025-05-15T04:16:08.000Z",
  "approved_at": null,
  "denied_at": null,
  "pending_at": null,
  "type": "PAYOUT"
}'

Responses

🟢200Success
application/json
Body

Example
{}
🟠400Bad Request
Modified at 2025-09-12 08:16:30
Previous
Webhook PAYIN SUCCESS
Next
Webhook PAYIN EXPIRED