Postbacks Settings

Postbacks notify your system when a Factoring Decline v1 payment or refund result becomes available.

Configure your URL

For an approved website, open the merchant portal and click API Settings for that website:

https://factoring.ltvx.dev/factoring/websites

In the Postbacks tab:

Setting	Description
Send postbacks	Enable this to send Factoring Decline v1 events.
Postback URL	HTTPS endpoint on your server that accepts postback requests.

Example:

https://merchant.example.com/webhooks/factoring-decline

Delivery format

Item	Value
Method	`POST`
Body	JSON
Content type	`application/json`
Timeout	30 seconds
Successful response	HTTP `200`

Only HTTP 200 is treated as successful. Any non-200 response, timeout, or network error is treated as a failed delivery.

Payload

{
  "event_id": "019eb47d-1ac1-72a8-9d90-8ff08b9e1a23",
  "clickID": "click-id-22132",
  "website_id": "019e72ef-a0ed-730c-8307-9786f1a602b6",
  "status": "success",
  "mode": "live",
  "orderID": "019ea3ec-51f9-73bf-9f21-a6d34755f74c",
  "transactionID": "019ea4a3-786f-7221-a5ca-c35ab4902fff",
  "scheduled_at": null,
  "amount": "6.99",
  "currency": "USD",
  "errorMessage": null
}

Payload fields

Field	Type	Description
`event_id`	string	Unique identifier for this postback event. Use it for idempotency.
`clickID`	string	The value originally sent as `tracking2`.
`website_id`	string	Website ID that generated the event.
`status`	string	`success`, `failed`, `processing`, or `refunded`.
`mode`	string	`live` or `test`.
`orderID`	string	Order identifier.
`transactionID`	string/null	Transaction identifier, or `null` when it is not available.
`scheduled_at`	string/null	Scheduled processing time, or `null` when not applicable.
`amount`	string	Amount formatted with two decimal places.
`currency`	string	ISO 4217 currency code.
`errorMessage`	string/null	Failure reason when `status` is `failed`; otherwise `null`.

Retry schedule

Retry	Delay
1	60 seconds
2	300 seconds
3	900 seconds
4	1800 seconds

A successfully delivered postback is not sent again for the same transaction and postback type.