Ba-developer

API oyo ekipi na yo ekosepela na yango mpenza

REST oyo ebongwanaka te, ba-idempotency key, ba-webhook oyo esinyami mpe sandbox na banzela ya kondakisa, mpo okangisa nyonso banda na ebandeli tii na suka liboso ata falanga moko etambola.

Fungola konti

Esalemi mpo na ba-developer

Bozwi na yo ya liboso na request moko kaka

REST ya peto, enveloppe ya JSON oyo ebongwanaka te, mpe ID ya request na eyano moko na moko. Sandbox ezali ndenge moko na production: API moko, ba-status moko, ba-webhook moko.

Bafungola ya sandbox mpe ya production, moko na moko mpo na app na yango
Ba-webhook oyo esinyami na HMAC, na libateli mpo na replay
Idempotency key na request nyonso oyo etambwisaka mbongo
Ba-erreur ya polele oyo eyebisaka yo mpenza nini osengeli kobongisa
Ndimbola ya OpenAPI, liboke ya Postman mpe llms.txt, nyonso ebimisami
Ba session ya kofuta oyo ezali na biso mpe callback ya pete mpo na bakangisi CRM, ERP mpe magazini

Tanga mikanda Mokanda ya kokangisa

POST /v1/collections

curl https://api.capayglobal.com/v1/collections \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: 9f1c-collect-01" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "2500",
    "currency": "XAF",
    "country": "CM",
    "method": "mobile_money",
    "msisdn": "2376XXXXXXXX",
    "merchant_reference": "order-1042"
  }'

201 Created

{
  "status": "success",
  "data": {
    "id": "col_9xKQ2mD41Vb8",
    "object": "collection",
    "status": "pending",
    "amount": "2500",
    "currency": "XAF",
    "country": "CM",
    "method": "mobile_money",
    "merchant_reference": "order-1042",
    "fees": {
      "platform_fee": "50",
      "provider_fee": "0",
      "total_fee": "50",
      "bearer": "merchant"
    },
    "net_amount": null,
    "livemode": false,
    "created_at": "2026-08-30T12:04:11Z"
  },
  "request_id": "req_b0f3d2c1"
}

Kokongola na yo ya liboso

Bosengi moko esalaka mokano ya kofuta, ezongisaka id ya bosengi mpe, mpo na mbongo ya telefone, etindaka bosengi na telefone ya mofuti. Sandbox esalaka lokola production mpenza.

Zwa bafungola na yo ya komekaSala konti mpe bafungola ya sandbox ekomonana mbala moko na lokasa na yo ya mosali ya programme. Bafungola ya production efungwamaka nsima ya bondimi ya mombongo.

POST /v1/collections

curl -X POST https://api.capayglobal.com/v1/collections \
  -H "Authorization: Bearer sk_test_XXXXXXXXXXXX" \
  -H "Idempotency-Key: col-order-10482-a1b2c3" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5000",
    "currency": "XAF",
    "country": "CM",
    "method": "mobile_money",
    "msisdn": "+237650000001",
    "merchant_reference": "order-10482"
  }'

Eyano

{
  "status": "success",
  "data": {
    "id": "col_7Qm3k1Xa9Zr4",
    "object": "collection",
    "status": "pending",
    "amount": "5000",
    "currency": "XAF",
    "auth_model": "STK_PROMPT",
    "livemode": false
  },
  "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

201 Created

Mituya ezali basinga ya decimale na ndelo ya API mpe biteni mike na buku, yango wana eloko ebungaka te. Libiangi nyonso oyo ememaka mbongo ezwaka fungola ya idempotency mpe eyano nyonso ememaka id ya bosengi oyo okoki koloba na lisalisi.

SDK ya serveur

Bazipeli ya moke oyo ezali na ndenge likolo ya API REST se moko, na idempotency mpe botali ya signature na kati.

TypeScript and NodeEkobima kala mingi te@capay/sdk

Import

import { Capay } from '@capay/sdk';

Ezali naino te na npm. Molongo ya import likolo ezali ya nsuka, yango wana bosangisi na yo ekobongwana te ntango ekobima.

Tanga litambwisi

PythonEkobima kala mingi tecapay

Import

from capay import Capay

Ezali naino te na PyPI. Molongo ya import likolo ezali ya nsuka, yango wana bosangisi na yo ekobongwana te ntango ekobima.

Tanga litambwisi

PHPEkobima kala mingi tecapay/capay-php

Import

use Capay\CapayClient;

Ezali naino te na Packagist. Molongo ya import likolo ezali ya nsuka, yango wana bosangisi na yo ekobongwana te ntango ekobima.

Tanga litambwisi

Talela webhook nyonso

Ba signature etangami na nzoto ya mobesu mpe ekokanisami na ntango ya kokakama, mpe elembo ya ntango oyo eleki basegonde 300 eboyami. Kondimela ata moke te webhook oyo otali te.

X-Capay-Signature

# T is the t= value from X-Capay-Signature; delivery.json is the raw body as received.
T=1767225600
SECRET=whsec_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

{ printf '%s.' "$T"; cat delivery.json; } \
  | openssl dgst -sha256 -hmac "$SECRET" -r | cut -d' ' -f1
# Compare the printed hex with each v1= value in the header (either may match
# during a secret rotation), and reject the delivery if |now - T| > 300 s.

Motó ya signature

X-Capay-Signature: t=1767225600,v1=6f8b4c2d9e0a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d9e1f0a2b4c6d8e0f1a3b5c
X-Capay-Event-Id: evt_2n4Kq8Zr41Xa
X-Capay-Event-Type: collection.completed

Kokoma mpe komeka lisusu

Kokoma oyo elongi te emekami lisusu na programme oyo ebongwanaka te: 1m, 5m, 30m, 2h, 6h, 12h, 24h, 24h. Endpoint oyo ekweyi mbala 8 elandani ekokangama mpe okoyebisama, yango wana endpoint ekufi emelaka makambo na kimia te.

Basekele mibale ya signature ekoki kosala na ntango moko, yango wana okoki kobongola yango kozanga kobungisa likambo. Boya nyonso oyo ezali libanda ya lininisa ya basegonde 300 mpe bomba id ya likambo mpo ete kozongisa ezala na mabe te.

Bisaleli mosusu

Bandimbola oyo masini ekoki kotanga, liboke oyo okoki kokotisa, mpe bisaleli oyo etangaka yango.

llms.txtMikanda nyonso esangisami mpo na basungi ya kode, mpo ete AI na yo eyanola mpo na API na biso na makomi na biso.Ndimbola ya OpenAPIKontra mobimba, esalemi na API. Kotisa yango mpo na kotonga kliya na monoko nyonso.Liboke ya PostmanEndpoint nyonso na banzoto ya ndakisa mpe bavariable ya esika, ezali pene ya kosala na sandbox.

Molongo ya mitindoEzali koyaSala bafuti ya komeka, landa makambo mpe zongisa webhook na masini na yo.@capay/cli

Serveur ya MCPEzali koyaPesa mosungi na yo ya kode ndingisa ya kotanga sandbox na yo mpo ete ayanola na ba données na yo ya solo.@capay/mcp

Script ya kofutaEzali koyaFungola lokasa ya kofuta na lininisa likolo ya lokasa na yo na esika ya kotinda moto esika mosusu.https://pay.capayglobal.com/capay.js

Tala plateforme mobimba

Bozwi mbongoBozwi ya mobile money mpe ya banki Kofuta na cryptoUSDT, USDC mpe mosusu, esalamaka na dolare ya Amerika Botindi mbongoBotindi ya mbongo na ba-wallet na nzela ya programme NtaloNtalo na transaction moko na moko, ntalo ya kokangama te Bisika tozaliBikolo mpe banzela oyo ezali kosala FAQBiyano ya mokuse na mituna oyo batunaka mingi

Banda kozwa mbongo na Afrika mobimba lelo

Fungola konti ya ofele, tonga na sandbox, mpe banda mosala ya solo sima ya botali.

Fungola konti

Yebisa biso banzela mpe motuya ya mbongo na yo tango nyonso olingi.