Skip to content

You call usYou call DataFlair. You write a client for this API. DataFlair does not call your server.

Postback status values ​

The optional status field tells DataFlair the state of the conversion in your system. Leave it out and DataFlair uses approved.

Values ​

StatusMeaning
approvedAccepted and counted in the main report. This is the default.
pendingWaiting for validation or settlement.
rejectedInvalidated. It stays visible when you filter reports by status.
holdHeld back for now.
adjustedUpdated after the original event.

Send approved when the conversion is final. Send pending while your own checks are still running. A postback records the state at the time you send it.

Things to know ​

  • The default is approved. A postback with no status counts in reports at once. Do not send a test event to a live program without a status that says what it is. See Testing postbacks for the test tool that marks events as tests.
  • A repeat does not change the status. Sending the same postback_id again returns the duplicate response. See Idempotency.
  • Any other value fails. DataFlair answers 422 with validation_error for a status outside the five above.

Docs version 1.0.1