Skip to main content

Payments

A Payment represents a mobile money debit from a customer’s phone. When you create a payment, the customer receives a prompt to confirm the transaction.

Payment Lifecycle

CREATED → OPERATOR_PENDING → USER_CONFIRMING → DEBITED → SETTLED
A payment can also move to FAILED, EXPIRED, or CANCELLED at various stages.

Amounts

All amounts are in centavos (smallest currency unit):
  • 10000 = 100.00 CVE
  • 500000 = 5,000.00 AOA

Idempotency

Use the Idempotency-Key header to safely retry payment creation without creating duplicates.

Endpoints

MethodPathDescription
POST/v1/paymentsCreate a payment
GET/v1/payments/{id}Get a payment
GET/v1/paymentsList payments
POST/v1/payments/{id}/confirmConfirm (sandbox only)
POST/v1/payments/{id}/cancelCancel a payment