Send a FaucetPay payout with the v1 API
A minimal, correct call to FaucetPay's /api/v1/send endpoint, including the part almost everyone gets wrong: the amount is in the coin's smallest unit, not USD.
FaucetPay
Payouts, balance checks, merchant deposits and IPN verification against the FaucetPay API.
7 entries
Verify a FaucetPay merchant payment before crediting it
The callback from FaucetPay's merchant checkout is not proof of payment. Here is the server-side verify call, including the endpoint shape that quietly 404s if you get it wrong.
Convert USD balances to coin units for a payout
If your ledger is in dollars and your payout API is in satoshi, this is the conversion, with the guard that stops a stale price from emptying your wallet.
Check your FaucetPay balance before you promise a payout
One call that stops the worst failure mode on a faucet: telling a user they were paid when the wallet was already empty.
Send a user to FaucetPay merchant checkout
An auto-submitting form POST with your own reference in the custom field — the field that makes the deposit traceable when it comes back.
Credit a deposit exactly once, however many callbacks arrive
A unique index on your own reference turns duplicate callbacks, browser refreshes and manual replays into no-ops instead of free balance.
A payout queue that survives an API that says nothing
Auto-pay when the API answers, hold when it does not, and never refund on a timeout. The three-state queue that keeps a faucet solvent.