Receive a Factoring Decline v1 postback

wbhk

/webhooks/factoring-decline

Configure your merchant postback URL in the portal under API Settings.

The URL shown here is only an example merchant endpoint. Your actual postback URL can be any HTTPS endpoint you configure in the merchant portal.

Factoring Decline v1 sends this JSON payload to your configured URL when a payment result or refund result is available. Your endpoint must respond with HTTP 200 for the delivery to be marked successful.

Non-200 responses, network errors, and timeouts are treated as failed deliveries and may be retried.

Payload

clickID

string

required

Merchant click ID or order reference originally sent as tracking2 in the create order request.

status

string

enum

required

Current result status for the payment or refund.

Allowed:

orderID

string

required

Internal order identifier associated with the processed order.

transactionID

string

required

Internal transaction identifier associated with the processed payment or refund.

amount

string

required

^[0-9]+(\.[0-9]{2})$

Transaction amount formatted with two decimal places.

currency

string

required

length between 3 and 3

^[A-Z]{3}$

ISO 4217 currency code.

mode

string

enum

required

Processing mode for the postback event. live is used for live traffic; test is used for test traffic.

Allowed:

errorMessage

string

required

Failure reason when status is failed; otherwise an empty string.

Responses

200

Return HTTP 200 to acknowledge successful receipt.

default

Any non-200 response is treated as a failed delivery.

Loading…