ገንቢዎች

ቡድንዎ በእውነት የሚወደው API

የሚገመት REST፣ የኢዴምፖተንሲ ቁልፎች፣ የተፈረሙ ዌብሁኮች እና የተመሰሉ መስመሮች ያሉት ሳንድቦክስ፣ አንድ ፍራንክ ከማንቀሳቀስዎ በፊት ከጫፍ እስከ ጫፍ እንዲዋሃዱ።

መለያ ይፍጠሩ

ለገንቢዎች የተሠራ

የመጀመሪያ ገቢ ክፍያዎ በአንድ ጥያቄ

ንጹህ REST፣ የሚገመት የJSON ቅርጸት እና በእያንዳንዱ ምላሽ ላይ የጥያቄ መለያ። ሳንድቦክሱ ምርትን ያንጸባርቃል: ያው API፣ ያው ሁኔታዎች፣ ያው ዌብሁኮች።

በየመተግበሪያው የተከለሉ የሳንድቦክስ እና የምርት ቁልፎች
በHMAC የተፈረሙ ዌብሁኮች ከድግግሞሽ ጥበቃ ጋር
ገንዘብ በሚያንቀሳቅስ እያንዳንዱ ጥሪ ላይ የኢዴምፖተንሲ ቁልፎች
ምን ማስተካከል እንዳለብዎ በትክክል የሚነግሩ የተተየቡ ስህተቶች
የ OpenAPI ዝርዝር፣ የ Postman ስብስብ እና llms.txt፣ ሁሉም ታትመዋል
ለCRM፣ ERP እና የሱቅ አያያዦች የተስተናገዱ የክፍያ ክፍለ ጊዜዎች እና ጠፍጣፋ ኮልባኮች

ሰነዶቹን ያንብቡ የውህደት መመሪያ

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"
}

የመጀመሪያ መሰብሰብዎ

አንድ ጥያቄ የክፍያ ሐሳብ ይፈጥራል፣ የጥያቄ መለያ ይመልሳል፣ ለሞባይል ገንዘብም ጥያቄውን ወደ ከፋዩ ስልክ ይልካል። የሙከራ አካባቢው ልክ እንደ ምርት ይሠራል።

የሙከራ ቁልፎችዎን ያግኙመለያ ይክፈቱ፤ የሙከራ ቁልፎቹ ወዲያውኑ በገንቢ ገጽዎ ላይ ይታያሉ። የምርት ቁልፎች የንግድ ማረጋገጫ ካለቀ በኋላ ይከፈታሉ።

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"
  }'

ምላሽ

{
  "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

መጠኖች በ API ጠርዝ ላይ የአስርዮሽ ጽሑፎች፣ በመዝገቡ ውስጥ ደግሞ ትንንሽ ክፍሎች ናቸው፤ ስለዚህ ምንም አይጠፋም። ገንዘብ የሚያንቀሳቅስ እያንዳንዱ ጥሪ የ idempotency ቁልፍ ይወስዳል፣ እያንዳንዱም ምላሽ ለድጋፍ ሊነግሩት የሚችሉት የጥያቄ መለያ ይይዛል።

የአገልጋይ SDK

በተመሳሳዩ REST API ላይ ቀጫጭንና ዓይነት ያላቸው መጠቅለያዎች፣ idempotency እና የፊርማ ማረጋገጫ ውስጥ ተካተዋል።

TypeScript and Nodeበቅርቡ ይታተማል@capay/sdk

ማስመጣት

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

ገና በnpm ላይ የለም። ከላይ ያለው የማስመጫ መስመር የመጨረሻ ነው፤ ስለዚህ ሲታተም ውህደትዎ አይለወጥም።

መመሪያውን ያንብቡ

Pythonበቅርቡ ይታተማልcapay

ማስመጣት

from capay import Capay

ገና በPyPI ላይ የለም። ከላይ ያለው የማስመጫ መስመር የመጨረሻ ነው፤ ስለዚህ ሲታተም ውህደትዎ አይለወጥም።

መመሪያውን ያንብቡ

PHPበቅርቡ ይታተማልcapay/capay-php

ማስመጣት

use Capay\CapayClient;

ገና በPackagist ላይ የለም። ከላይ ያለው የማስመጫ መስመር የመጨረሻ ነው፤ ስለዚህ ሲታተም ውህደትዎ አይለወጥም።

መመሪያውን ያንብቡ

እያንዳንዱን webhook ያረጋግጡ

ፊርማዎች በጥሬው አካል ላይ ተሰልተው በቋሚ ጊዜ ይነጻጸራሉ፣ ከ300 ሰከንድ የበለጠ ያረጀ የጊዜ ማህተምም ውድቅ ይደረጋል። ያላረጋገጡትን webhook በጭራሽ አያምኑ።

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.

የፊርማ ራስጌ

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

ማድረስና ድጋሚ ሙከራ

ያልተሳካ ማድረስ በተወሰነ መርሐ ግብር ይደገማል፦ 1m, 5m, 30m, 2h, 6h, 12h, 24h, 24h። በተከታታይ 8 ጊዜ የሚወድቅ መድረሻ ይዘጋል እርስዎም ይነገርዎታል፤ ስለዚህ የሞተ መድረሻ ክስተቶችን በዝምታ አይውጥም።

ሁለት የፊርማ ሚስጥሮች በአንድ ጊዜ ንቁ ሊሆኑ ይችላሉ፤ ስለዚህ ክስተት ሳያጡ መቀያየር ይችላሉ። ከ300 ሰከንድ መስኮት ውጭ ያለውን ሁሉ ውድቅ ያድርጉ የክስተቱንም መለያ ያስቀምጡ፤ ድጋሚ መላክ ጉዳት እንዳይኖረው።

የቀረው መሣሪያ

በማሽን የሚነበቡ ዝርዝሮች፣ ማስመጣት የሚችሉት ስብስብ፣ እና የሚያነቧቸው መሣሪያዎች።

llms.txtሙሉው ሰነድ ለኮድ ረዳቶች ተጠቅልሎ፤ AI እርስዎ ስለ API ችን ከእኛው ጽሑፍ እንዲመልስ።የ OpenAPI ዝርዝርሙሉው ውል ከ API የተመነጨ። በማንኛውም ቋንቋ ደንበኛ ለመገንባት ያስመጡት።የ Postman ስብስብእያንዳንዱ መድረሻ ከምሳሌ አካላትና ከአካባቢ ተለዋዋጮች ጋር፣ በሙከራ አካባቢ ላይ ለማስኬድ ዝግጁ።

የትእዛዝ መስመርበቅርቡየሙከራ ክፍያዎችን ይፍጠሩ፣ ክስተቶችን ይከታተሉ እና webhook ወደ የራስዎ ማሽን ይድገሙ።@capay/cli

የ MCP አገልጋይበቅርቡየኮድ ረዳትዎ በእውነተኛ ውሂብዎ እንዲመልስ የሙከራ አካባቢዎን የማንበብ ፈቃድ ይስጡት።@capay/mcp

የክፍያ ስክሪፕትበቅርቡወደ ሌላ ገጽ ከመምራት ይልቅ የክፍያ ገጹን በራስዎ ገጽ ላይ በመስኮት ይክፈቱ።https://pay.capayglobal.com/capay.js

መድረኩን ያስሱ

ገቢ ክፍያዎችየሞባይል ገንዘብ እና የባንክ ገቢ ክፍያዎች የክሪፕቶ ክፍያዎችUSDT፣ USDC እና ሌሎችም፣ በአሜሪካ ዶላር የሚወራረዱ ወጪ ክፍያዎችበፕሮግራም የሚላኩ የዋሌት ክፍያዎች ዋጋየየግብይት ተመኖች፣ ቋሚ ክፍያ የለም ሽፋንበቀጥታ የሚሠሩ ገበያዎች እና ዘዴዎች ተደጋጋሚ ጥያቄዎችለተለመዱ ጥያቄዎች አጭር መልሶች

ዛሬ በመላው አፍሪካ ክፍያ መሰብሰብ ይጀምሩ

ነጻ መለያ ይፍጠሩ፣ በሳንድቦክሱ ላይ ይገንቡ እና ከማረጋገጫ በኋላ ወደ ቀጥታ አገልግሎት ይግቡ።

መለያ ይፍጠሩ

ስለ ኮሪደሮችዎ እና መጠኖችዎ በማንኛውም ጊዜ ይንገሩን።