Pycer Express Prompt

Initiate an interactive, on-device authorization prompt directly to a customer’s registered mobile device for immediate authorization and settlement.

1. Initiate Payment Prompt

POST /api/v1/rails/express-prompt HTTP/1.1
Host: api.pycer.quantivogroup.com
Authorization: Bearer sk_live_your_pycer_key
Content-Type: application/json

Request Payload

{
  "merchantCode": "PYCER_889210",
  "accountReference": "ORD-2026-9921",
  "customerIdentifier": "+254712345678",
  "amount": "2500.00",
  "currency": "KES",
  "narration": "Pycer Enterprise Settlement",
  "callbackUrl": "https://api.yourdomain.com/v1/pycer/callback"
}

Response

{
  "transactionReference": "TXN_PYCER_991823746",
  "status": "PROMPT_DISPATCHED",
  "responseCode": "00",
  "responseDescription": "Payment prompt dispatched successfully to customer device",
  "customerMessage": "Prompt sent to customer device for PIN authorization."
}

2. Inbound Webhook Callback

Upon PIN authorization, Pycer pushes an immutable transaction receipt directly to your registered callback URL:

{
  "event": "payment.completed",
  "transactionReference": "TXN_PYCER_991823746",
  "merchantCode": "PYCER_889210",
  "accountReference": "ORD-2026-9921",
  "amount": 2500.00,
  "currency": "KES",
  "pycerReceiptNumber": "PC92817491XK",
  "settlementStatus": "SETTLED_ESCROW",
  "customerIdentifier": "+254712345678",
  "timestamp": "2026-11-14T13:08:00Z"
}

3. Query Transaction Status

Poll the real-time status of an ongoing Express Prompt:

GET /api/v1/rails/express-prompt/status?transactionReference=TXN_PYCER_991823746 HTTP/1.1
Host: api.pycer.quantivogroup.com
Authorization: Bearer sk_live_your_pycer_key