Start

Sandbox

Test host, official PANs, and a test panel on each operation. No real naira moves.

Point every call at https://payment-api-service.dev.payinvert.com with TEST keys, including invoicing. Invoice merchant calls use the secret key from the same Credentials set. Invoice bodies are JSON, not RSA-wrapped. Open Credentials in the header, then send from any operation page.

CORS

Some browsers block the host from this docs origin. If Send request says blocked, copy the cURL tab, or import the Postman collection.

Test cards

Sandbox Mastercard and Visa PANs. Copy one into Card payment.

Verve

Verve cards are not supported on the gateway yet. Charge Mastercard or Visa only.

SchemePANExpiryCVVPIN
Mastercard520000000000109612/50100-
Visa445653000000109612/50100-

Use expiry 12/50 and CVV 100. Any future expiry is accepted. To simulate an issuer decline, create the order for exactly 4005.00 and finish the card challenge with either test card. Order status is Failed, code 04. message is Transaction failed. paymentResponseMessage carries the issuer text. Never use these PANs on the live host.

Prefer a local client: download the Postman collection and import it. That path does not hit browser CORS.

A first charge

  1. Create order: copy the returned reference.
  2. Card payment or bank transfer with that reference.
  3. Order status, then Verify with the secret key.
  4. Invoices: create a draft, issue it, then pay (no api-key). Invoice paid status is handled by PayInvert when the order succeeds.