On this page: When a call converts
Advanced · Reference
Conversions
When a call pays, we call your postback URL so your platform knows which call converted and what it earned.
When a call converts
Paid by duration: when the call lasts the campaign's seconds, the number in the bid's seconds.
Paid per qualified caller: when the caller qualifies during the call. These campaigns need a postback URL before they go live, because without one your platform can't know which calls paid.
Your postback URL
Give your buyer a URL on your platform. We call it with GET and fill in these tokens:
| Token | What we put in |
|---|---|
{CALL_ID} | Your call ID, from the ping or the call-ID endpoint. |
{PHONE} | The caller's number. |
{PAYOUT} | What the call earned, in US dollars. |
The URL must start with https:// or http://, use {CALL_ID} or {PHONE} so we can name the call, and use no token in braces other than the three above.
For example:
https://your-platform.example/conversion?call={CALL_ID}&phone={PHONE}&payout={PAYOUT}Timing
We call your URL as soon as the call converts, and wait up to 15 seconds for an answer. Answer with HTTP 200.
If your platform doesn't answer, or answers with an error, we try again every minute for up to 7 days. Every attempt shows in your conversion log in the portal.
Testing your URL
Your buyer can send a test postback from their console. It uses a call ID that starts with IX-TEST-, +15555550100 as the number, and $0.00 as the payout, and it never touches a real call.