ኣማዓባልቲ

ጉጅለኹም ብሓቂ ዝፈትዎ 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 ከምኡውን ካልኦት፣ ብዶላር ኣመሪካ ዝኽፈሉ ወጻኢ ክፍሊታትብፕሮግራም ዝለኣኹ ናይ ዋሌት ክፍሊታት ዋጋናይ ነፍሲ ወከፍ ልውውጥ ተመናት፣ ቀዋሚ ክፍሊት የለን ዝርጋሐንጡፋት ዕዳጋታትን ኣገባባትን ቀጻሊ ሕቶታትንልሙዳት ሕቶታት ሓጸርቲ መልስታት

ሎሚ ኣብ መላእ ኣፍሪቃ ክፍሊት ምእካብ ጀምሩ

ናጻ ኣካውንት ክፈቱ፣ ኣብ ሳንድቦክስ ስርሑ፣ ድሕሪ መረጋገጺ ድማ ናብ ቀጥታ ኣገልግሎት እተዉ።

ኣካውንት ክፈቱ

ብዛዕባ ኮሪደራትኩምን መጠናትኩምን ኣብ ዝኾነ ግዜ ንገሩና።