Developer preview API v1

Sandbox only. No real funds moved. No production access is granted here. Access requirements

HTTP + JSON

Use the current typed REST contracts

Examples are generated from and tested against the actual PAP payment and refund DTOs.

Contract explorer

Expand an operation to inspect its parameters, examples, and response types. Requests are disabled in this public reference; documentation does not grant access to a live API.

Loading the API reference...

Prefer your own tooling? Open the raw JSON contract.

Authentication and scope

Send a bearer credential only to the endpoint assigned to your developer app. The server derives tenant, aggregator, country cell, and execution mode; callers cannot select or override those authority fields.

Amounts and identities

Send integer minor units and ISO 4217 currency codes. Keep the operation idempotency key stable across timeouts and retries, and never substitute a new payment identity after an ambiguous result.

Current surface

The checked contract includes payment and refund request/response DTOs. The documentation placeholder host is intentionally non-routable and is not a production endpoint.

Create payment request

POST /v1/payments
Authorization: Bearer <developer-app-credential>
Content-Type: application/json

{"amount_minor":1500,"currency":"ZMW","capture_method":"automatic","idempotency_key":"order-1042","setup_future_usage":"none"}

Create refund request

POST /v1/refunds
Authorization: Bearer <developer-app-credential>
Content-Type: application/json

{"payment_id":"pay_01900000000000000000000000","amount_minor":500,"reason":"customer_request","idempotency_key":"refund-order-1042"}