Skip to main content
Polls the state of a card purchase. Poll until a terminal state; treat anything else as still moving.

​
Request

​
string
required
The buyer’s email, the same one used to start the purchase.
​
string
required
The id returned by /card/purchase.

​
Response

​
string
One of:
​
string
Echo of the id you asked about.
​
string
What the buyer actually received, as a decimal string. Absent until the provider reports it.
​
string
Which asset deliveredAmount is in. Read it rather than assuming.
Credit deliveredAmount, never the amount that was charged. A single purchase carries four different figures: what the buyer typed, what the card was charged, what was converted after fees, and what actually landed on-chain. Only the last one is real. When it is absent, it is absent - do not substitute another.
processing is not a stalled payment. It means the money is in motion but has not settled; on sandbox it can stay that way indefinitely, because no chain transfer is ever broadcast there. See Sandbox.

​
Errors