Quickstart

Make your first request in about two minutes.

1. Get your API keyOpen Developer in the Fricopay app. Your key is there, and starts with fp_.
2. Fund your walletOn the same Developer page, tap Get payment details. Send Mobile Money to the number shown and put your unique reference in the Reference box. Your wallet is credited automatically a moment later.
3. Send a requestPass the key as a Bearer token. This one is free and lists the data networks and prices:

curl https://fricopay.com/devapi/cheap-data/networks \
  -H "Authorization: Bearer YOUR_KEY"

1. Listen for resultsOrders finish in seconds or minutes. Set a webhook and we tell you the moment one changes, or check the status yourself.

The basics

Explore the APIs

Authentication

Every request is signed with your API key. Here is how to get one, send it, and keep it safe.

Get your API key

Your key identifies your account and decides which wallet is charged.

1. Open DeveloperIn the Fricopay app, open the menu and choose Developer.
2. Copy your keyTap the eye to reveal it, then Copy. A key looks like fp_ followed by letters and numbers.
3. Use it on your serverSend it with every request, as shown below.

Send the key

Add it as a Bearer token in the Authorization header.

curl https://fricopay.com/devapi/cheap-data/networks \
  -H "Authorization: Bearer YOUR_KEY"

The same key works for Fricobiz too. Only Fricobiz test mode has a separate test key, which starts with fbt_. See Fricobiz.

Fund your wallet

Services you sell through the API are paid from your Fricopay wallet. Fund it without leaving Developer.

1. Enter an amountOn Developer, choose how much to add, from GHS 10 to GHS 5,000.
2. Send the moneySend Mobile Money from any number to the number we show. Type your unique reference in the Reference box, exactly as shown.
3. It is credited for youWe match your payment and add it to your wallet automatically. No fee.

Test with your own key

Paste your key in the box at the bottom of the left menu and every sample on this site fills it in for you. It is saved only in this browser.

Keep it safe

• Call the API from your backend, not from the browser.
• Store the key in an environment variable or a secrets manager.
• If a key leaks, make a new one in Developer. The old key stops working straight away.

Problems with your key

Responses and errors

Every response is JSON. Success and failure follow the same simple shape.

Response shape

Successful calls return the data you asked for with "ok": true. Failed calls return "ok": false and a plain error message you can show or log.

{
  "ok": true,
  "tx_id": "XNzAGOboUPPxeuKljGoJ",
  "status": "submitted"
}

{
  "ok": false,
  "error": "Invalid API key"
}

HTTP status codes

Rate limits

Each key can make up to 150 requests per minute. Go over and you get 429 with a Retry-After header. Some endpoints have their own, lower limits.

Handling orders safely

• Orders are not always instant. Treat pending and placed as in progress, and wait for a final status.
• Use a webhook to learn about final status without polling.
• If a request times out, check the order status before sending it again, so you never buy twice.
• Where an endpoint takes an external_order_id or user_reference, send your own ID. It makes your records easy to match.

Webhooks

Get a signed callback the moment an order or payment changes status, instead of polling.

Fricobiz payments

The webhook for collecting payments. We call you the moment a customer's payment is paid.

1. Set your addressIn the Fricobiz section of the Fricopay app, save a webhook URL that starts with https://, and copy the signing secret. You can also pass a callbackUrl when you create a payment to use a different address for that one.
2. Receive the callWe POST JSON to your URL when a payment is paid.
3. Check it, then replyVerify the signature, mark the order paid once, and reply with a 2xx status.

{
  "event": "payment.paid",
  "id": "9f2c1b7a4d5e6f708192a3b4",
  "reference": "order_12345",
  "amount": 50,
  "amountReceived": 50,
  "currency": "GHS",
  "payer": "AMA MENSAH",
  "network": "MTN",
  "paidAt": 1792500123456
}

Verify the signature

Compute the HMAC over the raw body, not over parsed JSON, and reject calls with an old timestamp.

import crypto from 'crypto';

// rawBody is the exact text we sent, before any JSON parsing.
export function isFromFricobiz(rawBody, header, secret, toleranceSeconds = 300) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const expected = crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) <= toleranceSeconds;
  const a = Buffer.from(expected), b = Buffer.from(parts.v1 || '');
  return fresh && a.length === b.length && crypto.timingSafeEqual(a, b);
}

// Express example
app.post('/webhooks/fricobiz', express.raw({ type: 'application/json' }), (req, res) => {
  if (!isFromFricobiz(req.body.toString(), req.get('X-Fricobiz-Signature') || '', process.env.FRICOBIZ_WEBHOOK_SECRET)) return res.sendStatus(401);
  const event = JSON.parse(req.body.toString());
  // event.event === 'payment.paid': mark the order paid, once
  res.sendStatus(200);
});

import hmac, hashlib, time

def is_from_fricobiz(raw_body: str, header: str, secret: str, tolerance=300) -> bool:
    parts = dict(p.split('=', 1) for p in header.split(','))
    expected = hmac.new(secret.encode(), f"{parts.get('t')}.{raw_body}".encode(), hashlib.sha256).hexdigest()
    fresh = abs(time.time() - int(parts.get('t', 0))) <= tolerance
    return fresh and hmac.compare_digest(expected, parts.get('v1', ''))

# Flask example
@app.post('/webhooks/fricobiz')
def fricobiz_webhook():
    if not is_from_fricobiz(request.get_data(as_text=True), request.headers.get('X-Fricobiz-Signature', ''), WEBHOOK_SECRET):
        return '', 401
    event = request.get_json()
    # event['event'] == 'payment.paid': mark the order paid, once
    return '', 200

Delivery and retries

• Reply with any 2xx status within 8 seconds. Redirects are not followed.
• If we do not get one, we try again after 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours and 24 hours.
• The same event can arrive more than once, so make your handler safe to run twice. The payment id is a good key.
• Missed one? Call Get a payment to see the current status.

Order events

The services API (airtime, data, bills and more) sends its own events when one of your orders changes.

Set the address in Developer in the Fricopay app. It has its own signing secret.

{
  "event": "order.placed",
  "data": {
    "service": "cheap_data",
    "reference": "MN-XXXX",
    "networkKey": "YELLO",
    "recipient": "0240000000",
    "capacity": 1,
    "amount": 4,
    "status": "placed"
  },
  "timestamp": "2026-05-24T21:00:00.000Z"
}

Order events are sent with the headers X-FricoPay-Signature (a hex HMAC-SHA256 of the raw body) and X-FricoPay-Event. We make up to 3 attempts, one and two seconds apart.

import crypto from 'crypto';

// Order events are signed with a plain hex HMAC-SHA256 of the raw body, using your signing secret from Developer.
export function isFromFricopay(rawBody, signature, secret) {
  const expected = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(expected), b = Buffer.from(signature);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Build with AI

Let your AI coding assistant read our docs and write the integration for you.

How it works

Works with Claude, ChatGPT, Cursor, Copilot and any assistant that can open a link.

1. Give it the docsPaste the link to fricopay.com/llms-full.txt into your assistant. It reads every endpoint, field and status in one go.
2. Tell it what to buildFor example: sell data bundles, send airtime, or collect Mobile Money payments. Use a ready-made prompt below.
3. Keep your key privateThe assistant writes code that reads your key from an environment variable. You never paste the key into the chat.

Links for your assistant

Three plain files, always up to date with this site.

Ready-made prompts

Copy one, change the last line to what you need, and paste it into your assistant.

You are helping me build on the Fricopay API.
Read https://fricopay.com/llms-full.txt first. It is the full documentation.
The machine-readable spec is https://fricopay.com/openapi.json.

Rules:
- Base URL is https://fricopay.com. Authenticate every request with the header Authorization: Bearer <key>.
- Read my API key from the environment variable FRICOPAY_API_KEY. Never write the key into code, logs or chat.
- Call the API from my server only, never from a browser or mobile app.
- Amounts are in Ghana cedis (GHS). Phone numbers are 10 digits starting with 0.
- Use the order reference to check status, and verify webhook signatures as the docs describe.

Task: 

Read https://fricopay.com/llms-full.txt, then add data bundle sales to my app using the Cheap data API.
1. Call GET /devapi/cheap-data/networks to list networks and prices, and show them to my customer.
2. When they choose one, call POST /devapi/cheap-data/purchase with networkKey, recipient and capacity.
3. Save the reference from the reply, then check GET /devapi/cheap-data/orders/:reference or listen for the webhook.
4. Treat placed and processing as in progress, success as delivered, and failed as refunded.
Read the key from FRICOPAY_API_KEY. Never hard-code it.

Read https://fricopay.com/llms-full.txt, then add Mobile Money checkout to my website using Fricobiz Collect.
1. On my server, call POST /fbapi/v1/payments with the amount and my own order reference.
2. Send the customer to the payUrl in the reply.
3. Receive the signed webhook, verify its signature, and only then mark the order as paid. Never trust the browser.
4. Use my test key (fbt_) while building so no real money moves.
Read the key from FRICOPAY_API_KEY. Never hard-code it.

Stay safe

• Put the key in an environment variable such as FRICOPAY_API_KEY.
• Test with a small amount first, and read the code before you run it.
• Ask the assistant to protect purchases from being sent twice: check the order reference before retrying.
• If a key is exposed, make a new one in Developer. The old one stops working at once.

Fricobiz

Collect Mobile Money payments on your own number, with a hosted pay page, checkout and signed webhooks.

How it works

Fricobiz turns your own phone into a payment gateway. Customers send Mobile Money to your number, the Fricobiz app reads the confirmation, and your site is told the payment is paid.

1. Set up FricobizOpen Fricobiz in the Fricopay app, subscribe, install the Fricobiz app on the phone that receives the money, and connect and verify your number.
2. Create a paymentFrom your server, call POST /fbapi/v1/payments. You get back a unique code and a hosted pay page.
3. The customer paysThey send the amount to your number with the code as the reference, or open the pay page, which shows them exactly what to do.
4. We tell your siteWhen the money arrives, the payment becomes paid and we send a signed webhook. Credit the order from that, never from the browser.

Your keys

Find both in the Fricobiz section of the app. Keys that start with fb_ were issued earlier and still work. Send either one as Authorization: Bearer .... Keep keys on your server. A key stops working if your Fricobiz plan has ended, until you renew.

Endpoints

curl -X POST https://fricopay.com/fbapi/v1/payments \
  -H "Authorization: Bearer fp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_12345" \
  -d '{"amount": 50, "reference": "order_12345", "customerName": "Ama Mensah", "callbackUrl": "https://yoursite.com/webhooks/fricobiz", "returnUrl": "https://yoursite.com/thanks"}'

{
  "ok": true,
  "payment": {
    "id": "9f2c1b7a4d5e6f708192a3b4",
    "reference": "order_12345",
    "amount": 50,
    "status": "pending",
    "code": "K7M2QX",
    "expiresAt": 1792500000000,
    "business": "Ama Stores",
    "payTo": [{ "number": "0241234567", "network": "MTN", "name": "Ama Stores" }],
    "payUrl": "https://fricopay.com/pay/9f2c1b7a4d5e6f708192a3b4"
  }
}

curl https://fricopay.com/fbapi/v1/payments/PAYMENT_ID \
  -H "Authorization: Bearer fp_YOUR_KEY"

Payment statuses

Checkout

Show the hosted pay page on top of your own site, without sending the customer away.

Create the payment on your server, pass its payUrl to the page, then open it:

<script src="https://fricopay.com/checkout.js"></script>
<script>
  // payment.payUrl comes from POST /fbapi/v1/payments, created on YOUR SERVER
  Fricobiz.checkout({
    payUrl: payment.payUrl,
    onSuccess: function (p) { /* p = { id, reference, amount, status } */ },
    onClose: function () { /* the customer closed it */ }
  });
</script>

Or add the pay link to any button or link:

<a href="#" data-fricobiz-pay="https://fricopay.com/pay/PAYMENT_ID">Pay with Mobile Money</a>

The pay page shows the number to pay and the reference, counts down the time left, and lets the customer confirm with the transaction ID from their Mobile Money message if the match is slow. It also has a help box for questions about the payment.

Test mode

Use your fbt_ key to try the whole flow with no money.

• Create payments with the test key. They work exactly like live ones, and are marked sandbox.
• Open the pay page of a test payment and use the buttons there to pretend the customer paid, or that it needs review.
• Your webhook fires as normal, with "sandbox": true in the body.

Chat widget

Add a live chat bubble to your site. Messages reach you in the Fricobiz app.

Paste this before the closing </body> tag. Your widget ID is in the Chat settings of the Fricobiz app.

<script src="https://fricopay.com/fbapi/widget.js" data-id="YOUR_WIDGET_ID" async></script>

Airtime

Send airtime to MTN, Telecel and AirtelTigo numbers from your app, paid from your wallet.

Networks

Pass one of these in the network field:

Endpoints

curl -X POST https://fricopay.com/devapi/v1/airtime \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"network":"MTN","phone":"233241234567","amount":5,"user_reference":"u_123"}'

curl -X POST https://fricopay.com/devapi/v1/airtime \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"network":"TELECEL","phone":"233201234567","amount":5,"user_reference":"u_123"}'

curl -X POST https://fricopay.com/devapi/v1/airtime \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"network":"AT","phone":"233271234567","amount":5,"user_reference":"u_123"}'

curl https://fricopay.com/devapi/v1/status/REFERENCE \
  -H "Authorization: Bearer YOUR_KEY"

Data bundles

List the bundles available for a number, then buy the one you want.

Networks

Pass one of these in the network field:

Step 1 — List bundles for a number

curl "https://fricopay.com/devapi/v1/data/bundles?network=MTN&phone=233241234567" \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://fricopay.com/devapi/v1/data/bundles?network=TELECEL&phone=233201234567" \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://fricopay.com/devapi/v1/data/bundles?network=AT&phone=233271234567" \
  -H "Authorization: Bearer YOUR_KEY"

Step 2 — Buy the chosen bundle

curl -X POST https://fricopay.com/devapi/v1/data \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"network":"MTN","phone":"233241234567","bundle_id":"data_bundle_1","amount":0.5,"user_reference":"u_123"}'

curl -X POST https://fricopay.com/devapi/v1/data \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"network":"TELECEL","phone":"233201234567","bundle_id":"DATANVSTRDLY","amount":0.5,"user_reference":"u_123"}'

curl -X POST https://fricopay.com/devapi/v1/data \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"network":"AT","phone":"233271234567","bundle_id":"db_BigTime_Data_51MB_1GHC","amount":1,"user_reference":"u_123"}'

Status

curl https://fricopay.com/devapi/v1/status/REFERENCE \
  -H "Authorization: Bearer YOUR_KEY"

Cheap data

Sell affordable data bundles at live wholesale prices, delivered in about a minute.

• Live prices, refreshed regularly
• 4 networks: MTN, AT iShare, AT BigTime, Telecel
• Reseller-grade reliability

Endpoints

curl https://fricopay.com/devapi/cheap-data/networks \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/cheap-data/verify-beneficiary \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "networkKey": "YELLO",
    "recipient": "0241234567"
  }'

curl -X POST https://fricopay.com/devapi/cheap-data/purchase \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "networkKey": "YELLO",
    "recipient": "0241234567",
    "capacity": 1
  }'

curl https://fricopay.com/devapi/cheap-data/orders/REFERENCE \
  -H "Authorization: Bearer YOUR_KEY"

curl https://fricopay.com/devapi/cheap-data/orders/by-phone/0241234567 \
  -H "Authorization: Bearer YOUR_KEY"

curl https://fricopay.com/devapi/cheap-data/transactions \
  -H "Authorization: Bearer YOUR_KEY"

Order flow

What to expect after you buy.

• Your wallet is charged when you buy. A failed order is refunded.
• Use the reference from the purchase reply to check the status, or set a webhook and we tell you when it changes.
• Delivery usually takes a few minutes. Large bundles can take longer.

Bills and utilities

Pay TV subscriptions, ECG electricity and Ghana Water bills, and look up SIM owners.

DSTV / GOtv / Telecel Broadband

curl "https://fricopay.com/devapi/v1/utility/verify?service=DSTV&account=8226349986" \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/v1/utility \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"DSTV","account":"8226349986","amount":50,"user_reference":"u_123"}'

ECG Electricity

curl "https://fricopay.com/devapi/v1/ecg/meters?phone=233246912184" \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/v1/ecg \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"233246912184","meter":"13334792","amount":20,"user_reference":"u_123"}'

Ghana Water

curl "https://fricopay.com/devapi/v1/water/verify?meter=091019010006&phone=233242825109" \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/v1/water \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"233242825109","meter":"091019010006","session_id":"FROM_VERIFY_CALL","email":"user@example.com","amount":10,"user_reference":"u_123"}'

SIM Owner Verify

curl "https://fricopay.com/devapi/v1/msisdn/verify?phone=233246912184" \
  -H "Authorization: Bearer YOUR_KEY"

Status

curl https://fricopay.com/devapi/v1/status/REFERENCE \
  -H "Authorization: Bearer YOUR_KEY"

Virtual numbers

Buy a temporary phone number, wait for the SMS code, and read it from the API.

Endpoints

curl https://fricopay.com/devapi/virtual/services?country=usa \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/virtual/buy \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"usa","service":"whatsapp","operator":"any"}'

curl https://fricopay.com/devapi/virtual/order/123456 \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/virtual/cancel/123456 \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/virtual/finish/123456 \
  -H "Authorization: Bearer YOUR_KEY"

SMS

Send transactional SMS to Ghana numbers with your own sender ID.

Endpoints

curl -X POST https://fricopay.com/devapi/sms/send \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"0241234567","from":"MyApp","sms":"Hello from my app","unicode":"0"}'

curl https://fricopay.com/devapi/sms/orders \
  -H "Authorization: Bearer YOUR_KEY"

Social boost

Sell followers, likes and views on TikTok, Instagram, YouTube and more.

Endpoints

curl https://fricopay.com/devapi/booster/services \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/booster/quote \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 1234, "quantity": 1000}'

curl -X POST https://fricopay.com/devapi/booster/order \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 1234,
    "link": "https://tiktok.com/@user/video/123",
    "quantity": 1000
  }'

curl https://fricopay.com/devapi/booster/order/ORDER_ID \
  -H "Authorization: Bearer YOUR_KEY"

curl https://fricopay.com/devapi/booster/orders \
  -H "Authorization: Bearer YOUR_KEY"

Result checkers

Sell WAEC and BECE result checkers and get the serial and PIN back.

Endpoints

curl https://fricopay.com/devapi/checker/products \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/checker/buy \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "checkerType": "BECE",
    "phoneNumber": "0241234567"
  }'

curl https://fricopay.com/devapi/checker/order/REFERENCE \
  -H "Authorization: Bearer YOUR_KEY"

curl https://fricopay.com/devapi/checker/orders \
  -H "Authorization: Bearer YOUR_KEY"

AFA registration

Register customers for MTN AFA straight from your app.

Endpoints

curl -X POST https://fricopay.com/devapi/afa/register \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "Ama Mensah",
    "phone_number": "0240000000",
    "id_type": "Ghana Card",
    "id_number": "GHA-000000000-0",
    "dob": "1995-06-15",
    "location": "Accra",
    "occupation": "Trader",
    "external_order_id": "SHOP-10001"
  }'

{
  "ok": true,
  "tx_id": "XNzAGOboUPPxeuKljGoJ",
  "afa_id": 2980,
  "status": "submitted",
  "total_paid_ghs": 11,
  "currency": "GHS"
}

curl https://fricopay.com/devapi/afa/registrations/TX_ID \
  -H "Authorization: Bearer YOUR_KEY"

curl https://fricopay.com/devapi/afa/registrations \
  -H "Authorization: Bearer YOUR_KEY"

Football data

Live scores, results, fixtures and predictions for matches worldwide.

Endpoints

curl https://fricopay.com/devapi/football/status \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://fricopay.com/devapi/football/livescores?when=today" \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://fricopay.com/devapi/football/match?home=Real+Madrid&away=Oviedo&when=today" \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://fricopay.com/devapi/football/match-detail?home=Castellon&away=Almeria" \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://fricopay.com/devapi/football/predictions?when=today" \
  -H "Authorization: Bearer YOUR_KEY"

Sample responses

{
  "ok": true,
  "teams": "Castellón vs Almeria",
  "homeTeam": { "name": "Castellón", "logo": "https://fricopay.com/football/logo/castellón.png" },
  "awayTeam": { "name": "Almeria", "logo": "https://fricopay.com/football/logo/almeria.png" },
  "score": "1 - 1",
  "status": "FT",
  "events": [
    { "minute": "5'", "type": "yellow_card", "player": "J. Morcillo", "side": "away" },
    { "minute": "44'", "type": "goal", "player": "F. Brignani", "side": "home" }
  ],
  "odds": [
    { "bookmaker": "Megapari", "home": "1.81", "draw": "3.78", "away": "4.45" }
  ],
  "prediction": "Castellón",
  "analysis": "Teams Castellón and Almeria will try to find out who is the best..."
}

{
  "ok": true,
  "when": "today",
  "count": 119,
  "matches": [
    {
      "kickoff": "16:00",
      "home": "Admira Wacker",
      "away": "Floridsdorfer AC",
      "correct_score": "1:0",
      "tip": "Under 4.5",
      "league": "Austria 2. Liga"
    }
  ]
}

Bet code converter

Convert a bet code from one bookie to another.

• Auto-refund on conversion failure
• 17 bookies supported (SportyBet, 1xBet, Betika, Odibet, MSport, Betpawa, 22bet & more)
• Same provider used by Fricopay's consumer feature

Endpoints

curl https://fricopay.com/devapi/bet-converter/bookies \
  -H "Authorization: Bearer YOUR_KEY"

curl -X POST https://fricopay.com/devapi/bet-converter/lookup \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "originBookie": "sportybet:gh",
    "code": "8CJFR6"
  }'

curl -X POST https://fricopay.com/devapi/bet-converter/convert \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "originBookie": "sportybet:gh",
    "destBookie": "1xbet:gh",
    "code": "8CJFR6"
  }'

curl https://fricopay.com/devapi/bet-converter/history \
  -H "Authorization: Bearer YOUR_KEY"

{
  "ok": true,
  "destinationCode": "FCA88",
  "originOdds": 8.78,
  "odds": 9.01,
  "noOfEntries": 2,
  "charged": 1.50,
  "currency": "GHS"
}