Huch API Documentation

Appearance

Webhook payload example ​

This webhook content example represents a payment status update notification.

It includes details such as the payment ID, type, payment_status, currency, amount, ISO status, order reference.

This information allows you to track and respond to changes in payment status within your application.


How it works ​

  1. The webhook is triggered by the payment status change.
  2. The webhook is sent to the URL specified in the webhook subscription. look at Webhook subscription
  3. The webhook is sent as a POST request with the following payload:

Note ​

status is Deprecated use payment_status instead

Example of a webhook payload when the payment is initiated ​

json
{
    "payment_id":"a863ed8b-e16a-4fe7-8460-cdddbd219fa9",
    "type":"WIRE_TRANSFER",
    "status":"PENDING",
    "currency":"EUR",
    "amount":970,
    "isoStatus":null,
    "order_ref":"42837M",
    "payment_status":"NEW",
    "status_info":"Transaction has just been initiated. No customer action yet.",
    "bank_ref":null,
}

Example of a webhook payload when the payment is updated ​

json
{
    "payment_id":"a863ed8b-e16a-4fe7-8460-cdddbd219fa9",
    "type":"WIRE_TRANSFER",
    "status":"PENDING",
    "currency":"EUR",
    "amount":970,
    "bank_ref":null,
    "isoStatus":null,
    "order_ref":"42837M",
    "payment_status":"NEW",
    "status_info":"Transaction has just been initiated. No customer action yet.",
    "bank_ref":null,
    "status_change":{
        "old":"NEW",
        "new":"PENDING"
    }
}

isoStatus ​

"isoStatus": {
        "code": "ACSP",
        "name": "AcceptedSettlementInProcess"
    }

AcceptedSettlementInProcess (ACSP)

  • All preceding checks such as technical validation and customer profile were successful and therefore the payment initiation has been accepted for execution.

ISO Status Codes Overview ​

  • ISO status codes provide standardized information about the state of a payment transaction.

  • Each code represents a specific stage or outcome in the payment process. For a detailed explanation of these codes and their implications for your transactions, please refer to our comprehensive guide.

Read more

Before going live, make sure your endpoint validates incoming notifications — see Webhook Security for signature verification, timestamp checks and replay protection.