Hosted checkout
Redirect customers to a hosted gateway that supports multiple payment methods — no PCI scope on your side.
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.
# 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"
}'
Everything you need to accept money in Angola and DRC, built for developers and reconciled by default.
Redirect customers to a hosted gateway that supports multiple payment methods — no PCI scope on your side.
Settlements are executed by the processors within 24 hours and credited straight to your respective account.
HTTPS everywhere, mandatory bearer tokens, and HMAC-SHA-256 signed callbacks on every transaction.
WiPay routes each transaction to the right processor automatically, so you plug in once and forget it.
Drive accepted, timeout, rejected, and error outcomes with magic phone numbers — same rules as production.
Sandbox and production share a single host. Switch environments by swapping the token, not the URL.
The customer goes through the simple and beautiful hosted page, and we notify your backend with a signed callback the moment he finishes.
Your server starts the payment.
# 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…
The customer pays on the hosted page.
Como gostaria de efetuar o pagamento?
WiPay posts the signed result back.
# 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"
}'
A clean REST surface, predictable status codes, and callbacks you can trust. Verify the signature, read the payload, ship.
https://api.wipay.ao{
"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
Pay a flat percentage per transaction — no setup fees, no monthly minimums.
| Payment method | Transaction fee |
|---|---|
| 🇦🇴Angola | |
| Multicaixa Express | 1% |
| Referência Multicaixa | 1% |
| é-Kwanza | 0% |
| PayPay | 0% |
| Unitel Money | 0% |
| Afrimoney | 0% |
| 🇨🇩DRC | |
| Rawbank (illicoCash) | 1% |
Sign up for a merchant account, grab your tokens, and accept your first payment today.
Tell us about your business and we'll get you set up.
Thank you for registering with WiPay. Your account has been created successfully. Please check your inbox for your access credentials.