Payment Authorisation

https://auth.zamupay.com

POST

/apps/graph/api/v1/cybersource/payment/authorise

Authorises a card transaction without capturing funds. A successful authorisation reserves the amount on the cardholder's account. Capture must follow separately.

Required fields:

Amount: Transaction amount (no currency symbol)

Currency: ISO 4217 code (e.g. KES, USD)

TransientToken OR PaymentInstrumentId (one required)

PayerAuthenticationId: Required if 3D Secure was performed

Test Cards:

Visa success: 4111 1111 1111 1111

Mastercard success: 5555 5555 5555 4444

Declined: 4000 0000 0000 0002

Insufficient funds: 4000 0000 0000 9995

Request

Authorization

Header Params

Body Params application/json

Examples

Responses

🟢201

text/plain

🟠402

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://auth.zamupay.com/apps/graph/api/v1/cybersource/payment/authorise' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "Transaction": {
    "Amount": "1000",
    "Currency": "KES",
    "TransientToken": "transientToken_ZpKnXq...",
    "RequestId": "ORD-20250424-00123",
    "PayerAuthenticationId": "AUTH-3DS-00456"
  },
  "BillingAddress": {
    "FirstName": "Jane",
    "LastName": "Doe",
    "Email": "jane.doe@example.com",
    "PhoneNumber": "+254712345678",
    "Country": "KE"
  }
}'

Response Example

201 - 201 Created — Authorized

{
  "AuthorisationId": "7297662780756597904950",
  "Status": "AUTHORIZED",
  "Amount": "1000",
  "Currency": "KES",
  "OrderId": "ORD-20250424-00123",
  "ProcessorResponse": {
    "ResponseCode": "00",
    "AvsCode": "Y",
    "CvnCode": "M"
  },
  "Timestamp": "2025-04-24T10:15:30Z"
}

Modified at 2026-05-07 13:08:30

Generate Capture Context

Payment Capture