Everything the till does is open to your platform: sell and top up gift cards, check and redeem them, quote businesses in bulk, and hear about every change by webhook. Official SDKs in four languages.
The docs are open to read. Test keys are free: sign up and start building straight away.
PHP, Node.js, Python and Java, with the same calls in each. They sign every request, add idempotency keys, check webhook signatures and give you one error type to branch on.
$afropin = new AfroPin\Client($keyId, $secret); $pin = $afropin->reseller->pins->sell([ 'catalog_id' => $catalogId, 'amount' => 5000, 'external_reference' => $orderId, 'first_name' => 'Ada', 'last_name' => 'Obi', 'email' => '[email protected]', ]); $pin['pin_code']; // deliver it to your customer
const afropin = new AfroPin(keyId, secret); const pin = await afropin.reseller.pins.sell({ catalog_id: catalogId, amount: 5000, external_reference: orderId, first_name: 'Ada', last_name: 'Obi', email: '[email protected]', }); pin.pin_code; // deliver it to your customer
afropin = Client(key_id, secret)
pin = afropin.reseller.pins.sell({
"catalog_id": catalog_id,
"amount": 5000,
"external_reference": order_id,
"first_name": "Ada", "last_name": "Obi",
"email": "[email protected]",
})
pin["pin_code"] # deliver it to your customer
AfroPin afropin = new AfroPin(keyId, secret); Map<String, Object> pin = afropin.reseller().pins().sell(Map.of( "catalog_id", catalogId, "amount", 5000, "external_reference", orderId, "first_name", "Ada", "last_name", "Obi", "email", "[email protected]")); pin.get("pin_code"); // deliver it to your customer
Signed webhooks to your server for each card you sell or accept, whoever acted: your till, our API, or the cardholder in their own account. Retried if your server is down, and resent from your dashboard.
pin.soldA card was sold, with its code to deliverpin.topped_upValue was addedpin.spentA card was redeemed, in full or in partpin.code_changedA card got a new codepin.expiredA card passed its expirypin.frozenA card was frozen, by you or its holderpin.unfrozenA frozen card can be spent againpin.movedMoney moved to or from a family cardquote.paidA business paid a brand's quotequote.sentA paid quote's cards went outEvery card you sell comes with a card account, linked from its emails and wallet pass. Your integration doesn't have to build any of it, and your webhook hears each change.
Every card under the customer's email, whoever sold it, signed in with a code by email.
Freeze a lost card, get a new code once a day, keep one code or set a daily limit.
The payment goes to the seller's wallet as a normal top-up, with the reseller's commission.
Cards for their family, funded from theirs, each with its own code and limit.
Hand a card to someone else, who gets a new code only they receive.
Cards in Google Wallet, with the code and QR ready at the till and the balance kept up to date.
Open a brand or reseller account online and create your test keys.
Use an SDK or the Postman collection, with test gift cards. No real money moves.
Work through the UAT cases in the docs to check every path, including errors.
Once your business is verified, switch to live keys and start trading.
One base URL, test and live mode, and how requests and responses are shaped.
Signing requests, idempotency keys and IP allow-lists, with worked examples.
Every error code, what it means and what to do next.
Check and redeem at your checkout, from first request to go-live.
Catalog, selling, top-ups and webhooks, end to end.
Every endpoint with examples, a Postman collection and the UAT cases to sign off.
Sign up online and create test keys straight away. Our integration team is on hand if you get stuck.