Referência Multicaixa · available in the sandbox

The payment method every Angolan knows.

Generate references with entity, number and expiry (Multicaixa payment references). Customers pay at any ATM, through internet banking or in the Express app — and BitPay reconciles to the cent.

Try it in the sandbox See pricing

create-reference.sh

curl -X POST https://api-sandbox.bitpay.ao/v1/payment_intents \
  -H "Authorization: Bearer $BITPAY_SK" \
  -H "Content-Type: application/json" \
  -H 'Idempotency-Key: invoice-2026-089' \
  -d '{
    "amount": 150000,
    "currency": "AOA",
    "payment_method": "multicaixa_reference"
  }'
 
# → "reference": { "entity": "90201",
#      "number": "148439209", "expires_at": "…" }

How it works

Generate the reference

Entity + 9-digit number + expiry, created via API in milliseconds.

The customer pays anywhere

ATM, internet banking or Multicaixa Express — whenever it suits them.

reference.paid event

The moment the payment lands, you get the webhook and the state updates everywhere.

Reconciliation to the cent

Every event is validated and deduplicated — you always know where every kwanza is.

Why with BitPay

The same payment object, the same webhooks and the same reconciliation as every other method — a single integration.

Controlled expiry

Set how long each reference stays valid. Expired ones don't vanish: they stay in the history.

Built for tuition and invoices

Issue in bulk for monthly fees, services and recurring charges.

No sensitive data

A reference exposes no one's account or card — secure by nature.

Full history

Every reference with its own trail: created, paid, expired — all auditable.

Generate your first reference in the sandbox.

Open the documentation