Create card payment | SenjaroPay Docs

curl -X POST https://api.senjaropay.com/senjaropay/merchant/card/pay \
     -H "x-idempotency-key: 7c9e6679-7425-40de-944b-e07fc1f90ae7" \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "payment_type": "card",
  "details": {
    "amount": 1000,
    "currency": "TZS"
  },
  "customer": {
    "firstname": "John",
    "lastname": "Customer",
    "phone_number": "255740000001",
    "email": "test.customer@example.com",
    "country": "Tanzania",
    "city": "Dar es Salaam",
    "address": "Sample Street"
  },
  "webhook_url": "https://example.com/webhooks/senjaropay/mock-callback"
}'

{
  "status": "success",
  "code": 200,
  "data": {
    "amount": {
      "currency": "TZS",
      "value": 1000
    },
    "expires_at": "2026-09-28T09:30:16.066Z",
    "object": "payment",
    "payment_type": "card",
    "reference": "CARD-CK7EVXQVK7CP",
    "status": "pending",
    "checkout_url": "https://cardpay.com/MI/payment.html?uuid=GgffdGF52eg6gA2AFd64Dchf"
  }
}

Opens a hosted card checkout. Redirect the customer to data.checkout_url. Send a new UUID in x-idempotency-key for every payment. Reuse that key only when retrying the same create request.

Authentication

x-api-keystring

API Key authentication via header

x-api-secretstring

API Key authentication via header

Request

This endpoint expects an object.

payment_typeenumRequired

Allowed values:

detailsobjectRequired

customerobjectRequired

webhook_urlstringRequiredformat: "uri"

HTTPS endpoint that receives the payment result.

Response

Checkout session created

statusstring

codeinteger

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

Authentication

Headers

Request

Response

Errors