Angola DRC

Collect payments across
Angola and DRC with a single API

WiPay is an asynchronous, plug-in-once payments platform. Integrate once and let WiPay route each transaction to the right processor — no wiring up methods one by one.

Read the docs
request.sh
# Start a new payment request
curl -X POST "https://api.wipay.ao/v1/hosts/payments" \
  -H "Content-Type: application/json" \
  -H "Authorization: <your-token>" \
  -d '{
    "amount": "123.45",
    "currency": "aoa",
    "reference_id": "123456789",
    "customer": "923000000",
    "callback_url": "https://your-site.ao/webhooks/wipay"
  }'
Digital Wallet· Banks· Multicaixa· Mobile Money
Why WiPay

One integration. Every payment method.

Everything you need to accept money in Angola and DRC, built for developers and reconciled by default.

💳

Hosted checkout

Redirect customers to a hosted gateway that supports multiple payment methods — no PCI scope on your side.

Fast settlement

Settlements are executed by the processors within 24 hours and credited straight to your respective account.

🔒

Secure by default

HTTPS everywhere, mandatory bearer tokens, and HMAC-SHA-256 signed callbacks on every transaction.

🔀

Smart routing

WiPay routes each transaction to the right processor automatically, so you plug in once and forget it.

🧪

Full sandbox

Drive accepted, timeout, rejected, and error outcomes with magic phone numbers — same rules as production.

🌍

One host, two worlds

Sandbox and production share a single host. Switch environments by swapping the token, not the URL.

The flow

We handle the complexity

The customer goes through the simple and beautiful hosted page, and we notify your backend with a signed callback the moment he finishes.

01

Request a payment

Your server starts the payment.

POST /v1/hosts/payments
# Your server → WiPay
curl -X POST "https://api.wipay.ao/v1/hosts/payments" \
  -H "Authorization: <your-token>" \
  -d '{
    "amount": "1000.00",
    "currency": "aoa",
    "customer": "923000000",
    "reference_id": "123456789",
    "callback_url": "https://your-site.ao/webhooks/wipay"
  }'

# ← 303 See Other
location: https://hosted.wipay.ao/?id=f3c6ff4c…
02

Customer pays

The customer pays on the hosted page.

Ngueve Manuel AOA 1 000.00 REF: 55

Como gostaria de efetuar o pagamento?

  • Carteira Digital
  • Bancos
  • Multicaixa
  • Mobile Money
powered by WiPay
03

Signed callback

WiPay posts the signed result back.

POST your callback_url
# WiPay → your callback_url
POST "https://your-site.ao/webhooks/wipay"
signature: 9a0f7c3e…c21

'{
    "id": "f3c6ff4c-3f05-4ce6-a253-…",
    "amount": "1000.00",
    "currency": "aoa",
    "status": "accepted",
    "status_reason": "2000",
    "reference_id": "123456789",
    "processor": "gpo"
  }'
For developers

Built to be integrated in an afternoon

A clean REST surface, predictable status codes, and callbacks you can trust. Verify the signature, read the payload, ship.

  • Single base URL — https://api.wipay.ao
  • Bearer token auth on every request
  • Exponential backoff on non 2xx callbacks status code results
  • Deterministic sandbox for every outcome
Explore the API reference →
{
  "id": "f3c6ff4c-3f05-4ce6-a253-28b871d682ab",
  "amount": "1000.54",
  "currency": "aoa",
  "status": "accepted",
  "status_reason": "2000",
  "reference_id": "123456789",
  "processor": "gpo"
}
# Set the customer number to drive the outcome
"customer": "900000000"  # → accepted
"customer": "900002004"  # → timeout
"customer": "900003000"  # → user rejected
"customer": "9........."  # → processor error 4000
Pricing

Simple, transparent pricing

Pay a flat percentage per transaction — no setup fees, no monthly minimums.

Payment method Transaction fee
🇦🇴Angola
Multicaixa Express1%
Referência Multicaixa1%
é-Kwanza0%
PayPay0%
Unitel Money0%
Afrimoney0%
🇨🇩DRC
Rawbank (illicoCash)1%

Ready to build with WiPay?

Sign up for a merchant account, grab your tokens, and accept your first payment today.