1. 2. Capture Context
ZamuPay API Documentation
  • Introduction
  • Definitions
    • Data Types
    • Transactions Response Codes
    • MCCMNC Codes
  • Authorization
    • Overview
    • Token Request
      POST
    • Find Transaction Routes
      GET
    • Health Check
      GET
  • Payouts
    • Overview
    • Payment Order Request Information
    • Mobile Money Requests
      • Overview
      • Mobile Transfers- Safaricom (M-Pesa)
      • Mobile Transfers - Airtel Money
    • Payment Order Requests - Business Transfers
      POST
    • Payment Order Requests - Bank Transfers
      POST
    • Find Payment Order By OriginatorConversationId
      GET
    • Reject Order By OriginatorConversationId
      POST
  • Pay-Ins
    • Payment Links
      • Overview
      • Create Payment Link
      • Find Payment Links By Id
      • Update Payment Link
    • Express Deposits
      • Overview
      • Express Deposit Request
      • Find Express Deposit By OriginatorConversationId
    • C2B IPN (Callback)
      • C2B IPN Overview
  • Card Payments
    • ZamuPay Server To Server Card Integration
      • Overview
      • 1. Authentication
        • Generate Auth Token
      • 2. Capture Context
        • Generate Capture Context
          POST
      • 3. Core Payment Flow
        • Payment Authorisation
        • Payment Capture
        • Payment Void
        • Payment Refund
      • 4. 3D Secure (Payer Authentication)
        • 3DS Setup
        • 3DS Enrolment Check
        • 3DS Validate Result
      • 5. Decision Manager (Fraud Screening)
        • Fraud Screen Transaction
      • 6. Payment Instruments (Card Tokenisation)
        • Save Card
        • Retrieve Saved Card
        • Delete Saved Card
      • 7. Transaction Search
        • Query Transactions
        • Get Transaction by ID
      • 8. Webhooks
        • Register Webhook Endpoint
        • List Registered Webhooks
        • Delete Webhook Endpoint
    • Cards Processing
      • Overview
      • Checkout Order Request
      • Query Checkout Request
      • Checkout Callback Request
  • Account Validation
    • Overview
    • Account Number Validation Request
    • Find KYC Status by SystemTraceAuditNumber
    • Account Validation
    • Find Account Validation Status by SystemTraceAuditNumber
  • Platform Services
    • Airtime Purchase
      • Overview
      • Airtime Purchase
      • Find Airtime Purchases By OriginatorConversationId
    • Customer Accounts
      • Balance Check
      • Find Charges By TransactionTypeId
    • Bill Payments
      • Overview
      • Bill Request Validation
      • Bill Request Payment
      • Find Bill Services
      • Find Bill Number By Service Id and Account Number
      • Find Bill Request By Originator Converstion Id
      • Bill Number
  1. 2. Capture Context

Generate Capture Context

https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
POST
/apps/graph/api/v1/cybersource/payment/context
Generates a Flex Microform context token. Required to securely collect card details on the partner's front end — card data never touches partner servers.
Pass the returned captureContext to the Flex Microform SDK in the browser. The SDK tokenises the card number and returns a transient token for subsequent payment calls.
Supported cardNetworks: VISA, MASTERCARD, AMEX, DISCOVER, CARNET, CARTESBANCAIRES, CUP, DINERSCLUB, EFTPOS, ELO, JCB, JCREW, MADA, MAESTRO, MEEZA

Request

Authorization
Header Params

Body Params application/json

Examples

Responses

🟢200
text/plain
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://auth.zamupay.com/apps/graph/api/v1/cybersource/payment/context' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
  "paymentTypes": ["CARD"],
  "cardNetworks": ["VISA", "MASTERCARD", "AMEX", "DISCOVER"]
}'
Response Response Example
{
  "responseCode": 0,
  "responseDesc": "Success",
  "responseData": {
    "captureContext": "eyJraWQiOiJ6dS0xLTEtMCIsImFsZyI6IlJTMjU2In0...",
    "expiresAt": "2025-04-24T12:30:00Z"
  }
}
Modified at 2026-05-07 13:08:30
Previous
Generate Auth Token
Next
Payment Authorisation
Built with