Postbacks

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

Configure your URL

Open:

https://factoring.ltvx.dev/api-settings

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

{
  "clickID": "click-id-22132",
  "status": "success",
  "orderID": "01950fae-7c1f-7290-9d6c-04fa4ff5c74a",
  "transactionID": "01950fb2-1b85-71d8-9b62-60f4cbdbec11",
  "amount": "7.00",
  "currency": "USD",
  "errorMessage": ""
}

Payload fields

Field	Type	Description
`clickID`	string	The value originally sent as `tracking2`.
`status`	string	`success`, `failed`, `processing`, or `refunded`.
`orderID`	string	Order identifier.
`transactionID`	string	Transaction identifier.
`amount`	string	Amount formatted with two decimal places.
`currency`	string	ISO 4217 currency code.
`errorMessage`	string	Failure reason when `status` is `failed`; otherwise empty.

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.