Changelog
API changes
What changed in the API, newest first. We add fields and endpoints without breaking existing integrations: code that ignores unknown fields keeps working.
Error codes, safer idempotency, test webhooks match live
- ChangedIdempotency keys are kept per endpoint, and a key is held while its first request runs: a duplicate sent at the same time gets
409instead of a second payment, refund, payout or transfer. Retries after the first request finished replay as before, including keys stored before this change. Idempotency - FixedA test-mode
payment/createno longer replays a live payment that used the same key, and test payments now replay too. - ChangedTest webhooks have the live shape:
amountis a decimal string (it was a number), and paid payments carrysettlement,amount_paidandunderpaid.test-completetakesunderpaidandamount_paidto rehearse a short payment. Live webhooks are unchanged. - Fixed
accounts/updateacceptsemail(contact address) and themanaged_fee_*names, and its answer includesemail. - FixedA form-encoded
falseis read as false foractiveonaccounts/update,include_cryptoonaccounts/sweepandmake_defaultonpayout-addresses. JSON booleans and0/1behave as before. - NewHourly limits (
429) send aRetry-Afterheader. - FixedSwap amounts are stored without float noise: 0.004 ETH no longer became 0.004000000000000001.
- NewError responses carry a
codenext toerror(e.g.unauthorized,invalid_request,rate_limited).status,errorandtimestampare unchanged. Errors - Changed
POST /payment/recheckalso accepts a JSON body or?tid=; form fields work as before. - New
POST /payment/test-completeis in the OpenAPI spec and the Postman collection (newtestKeyvariable). - FixedPHP SDK 1.1.1:
transfers->lookup()accepts thetxf_…id thattransfers->create()returns. - NewDocs: SDK examples in PHP, Node.js and Python, guides, a webhook event reference, sub-account docs and a test-mode console.
Choose the coins buyers see
- New
allowed_coinsonPOST /payment/createlimits the checkout to the coins and networks you list; it is echoed back. An unknown entry is refused with422. Limit the coins - New
GET /payment/methodswith your secret key returns only the coins your checkout allows; add?tid=for one payment. - Changed
metadata: "topup"is refused onpayment/create. It is reserved for wallet top-ups from the dashboard.
Underpayments are visible to your code
- NewThe webhook and
payment/lookupcarryamount_paidandunderpaidfor completed payments. Handle underpayments - ChangedUnderpayment tolerance is capped at 50%. Refunds are capped at what actually arrived.
- ChangedHourly ceilings per account: 150 API payments, 10 refunds, 10 transfers, 10 payout-link cancellations (
429). - ChangedManual payouts are limited per 24 hours (3 by default). Payouts, refunds and payout-link claims to one of our own deposit addresses are refused.
- ChangedProbe-style text (scripts, injections) in a refund reason, transfer note or payout-link label/note/metadata is refused with
422. - NewSDKs 1.1.0:
isUnderpaid()/amountPaid()webhook helpers.
New pricing, refund fee, receipts
- New
GET /accountreturnsfee_schedule(currentorlegacy) andfee_addons. Fees - NewRefunds on the current pricing carry a 1% fee:
REFUNDEDwebhooks addrefund_feeandrefund_net;GET /refundsrows addfee_usdandnet_usd. - NewA PDF receipt for every completed payment in the dashboard.
Safer webhooks and sub-accounts
- ChangedWebhook URLs must be public
http(s)addresses on port 80 or 443. Other targets are refused and logged, with no request made. - ChangedPayments complete after the network confirmations, not when the deposit is first seen.
- ChangedSub-accounts:
emailis stored as a contact address only; our fee can't be set below 2% + $0.10;active: truecan't lift a block we set. Sub-accounts
Payout links
- New
payout-link/create,lookup,cancel,resendandGET /payout-links, plus thePAYOUT_LINK_*webhooks. Guide