Gift Card Exchange API
in Nigeria

An exchange needs a rate it can show before the trade happens. The Eisy gift card exchange API gives businesses in Nigeria a live buy quote and a current sell rate per card type, both traceable back to the provider’s own price, settled from one USD wallet.

Rate sourceProvider's own price
Settles inUSD
Duplicate ordersReplayed, not repeated

How the exchange rate is set in Nigeria

Every price traces back to the provider’s own price for that catalogue item or card type.

BuyingSelling
Base priceProvider's catalogue priceProvider's payout for the card
Eisy adds or deductsA margin, tiered by order sizeA margin, tiered by card amount
When the price is fixedAt the moment you quoteOnly once the trade completes
You see it before committing✓ (quote endpoint)✓ (card-types endpoint)

Why businesses in Nigeria build on Eisy

  • •Every rate shown to a user in Nigeria traces back to the provider’s own price for that card, not an estimate.
  • •Quote a purchase without committing to it, or read the current sell rate for any card type before a user decides.
  • •A merchant-supplied clientReference makes every exchange idempotent, so a retried request never doubles up.
  • •Eisy confirms the order with the provider before settling either side of the exchange.
  • •Set your own prices as the provider: the quote and sell rate are your cost, so you set the exchange rate users in Nigeria see and keep the spread on every trade.

What you can build in Nigeria

Products teams launch on the Eisy API.

Gift card exchange platforms and kiosks
Apps that quote a rate before a user commits
Comparison tools that need a live, defensible rate
Cross-currency gift card arbitrage tools
Platforms exchanging gift cards for store credit
Treasury tools pricing gift card inventory in USD

Everything in the gift card API

Live buy pricing

Quote a purchase for any catalogue item before you order; the price is live, not held for later.

Sell rates by card type

See Eisy’s current USD rate for each sellable card type, derived from the provider’s own price for it.

Idempotent orders

Every buy or sell carries a clientReference you choose; replaying it returns the original trade, never a duplicate.

Trade webhooks

A signed event for every trade that completes, is rejected or fails, with the full trade record attached.

giftcard.sell.completed

Trade history

List or fetch any of your business’s trades, filtered by side, status, client reference or date.

Live code delivery

Codes for a completed purchase are fetched from the provider on request, never stored on Eisy’s side.

Built on events

Every event is delivered to your endpoint as a signed webhook and retried until you acknowledge it. A simplified example:

{
  "event": "giftcard.sell.completed",
  "data": {
    "eventClass": "giftcard",
    "eventType": "giftcard.sell.completed",
    "eventTime": "2026-11-18T10:32:00.000Z",
    "trade": {
      "id": "6f1b…",
      "type": "sell",
      "status": "COMPLETED",
      "clientReference": "order-10432",
      "cardAmount": "50.00",
      "quantity": 1,
      "currency": "USD",
      "amountCredited": "41.25"
    }
  }
}
giftcard.buy.completedgiftcard.buy.rejectedgiftcard.buy.failedgiftcard.sell.completedgiftcard.sell.rejectedgiftcard.sell.failed

Pricing

Set per business and shown in your merchant dashboard before every action you confirm. Want the consumer product instead? See trade gift cards yourself in Nigeria.

Buy marginAdded to the provider's price, tiered by order size
Sell marginDeducted from the provider's payout, tiered by card amount
SettlementDirectly to or from your USD wallet
Platform or monthly feeNone

How to go live with the gift card exchange API in Nigeria

From application to your first trade: verify your business, fund your wallet, connect your webhook and start buying or selling.

1

Apply and verify your business

Create an Eisy account, apply for a merchant account and complete business verification (KYB). We review and email you when you are approved.

Apply and verify your business
2

Get your keys and fund your wallet

Generate API keys, set your webhook URL and fund your business USD wallet. Invite admins and members to help manage your account.

Get your keys and fund your wallet
3

Price, trade and track by webhook

Quote a purchase or check a sell rate, submit the order from your business wallet, and receive a signed webhook once it completes.

Price, trade and track by webhook

FAQs about the gift card exchange rate

1

Who can use the gift card API in Nigeria?

Registered businesses in Nigeria and elsewhere. You need an approved business account (KYB), gift card trading enabled on your account, and an access token whose API key carries the GiftCardAPIs scope.

2

How do I see a price before I buy or sell?

POST /giftcards/buy/quote returns a live purchase price that is not held, and GET /giftcards/sell/categories/{id}/card-types lists the current USD rate for each card type. A sale’s final payout is set only once the trade completes, at that day’s rate.

3

What currency is a trade settled in?

Your business USD wallet. Purchases are debited and completed sales are credited in USD, even though sell rates are derived from the provider’s own local-currency price for each card.

4

How do I avoid placing the same order twice?

Every buy or sell request carries a clientReference you choose. Resubmitting the same reference for the same side returns the original trade instead of creating a new one.

5

How do I know when a trade is complete?

A signed giftcard.buy. or giftcard.sell. webhook is sent once a trade reaches a final status — completed, rejected or failed — and GET /giftcards/trades lets you list or poll any trade in the meantime.

6

What happens if a purchase can’t be confirmed with the provider?

It is held for review rather than silently refunded or delivered. An admin resolves it once the order is confirmed with the provider or found not to exist.

7

Are gift card codes stored anywhere?

No. Codes for a completed purchase are fetched live from the provider when you call GET /giftcards/trades/{id}/codes, and are never stored, logged or cached on Eisy’s side.

8

Can I set my own prices for my own customers?

Yes. The buy quote and the sell rate are your wholesale cost and payout with Eisy — what you charge or pay your own customers is entirely yours to set. You keep the margin between your price and the API’s, and Eisy never dictates or caps the retail price you show your users.

9

Can the cards pay merchants that charge in NGN?

Yes. The cards hold US dollars, and when a merchant charges in Nigerian naira (NGN) or any other currency, Visa or Mastercard converts the amount to USD at the time of the transaction.

Start exchanging gift cards

Apply for a merchant account, verify your business and make your first exchange in Nigeria.

Get Started