---
title: "POST /payments/initiate-card-payment"
method: POST
path: "/payments/initiate-card-payment"
tags: ["Payments", "Initiate"]
---

# POST /payments/initiate-card-payment

`POST /payments/initiate-card-payment`

## Request body

- union
  - object
    - `amount` string, required — Your payment amount
    - `orderReference` string, required — Your unique Order reference
    - `currency` 'USD', required
    - `customer` object, required — Customer
      - `id` string, required — Customer ID
    - `checksum` string — If enabled, this is the generated checksum of the payload. Refer to the [documentation](https://docs.clickpesa.com/home/checksum) for more details.
  - object
    - `amount` string, required — Your payment amount
    - `orderReference` string, required — Your unique Order reference
    - `currency` 'USD', required
    - `customer` object, required — Customer details
      - `fullName` string, required — Customer Full Name - must match with card holder name
      - `email` string, required — Valid customer email address
      - `phoneNumber` string, required — Valid customer phone number, starting with country code and without the plus sign, e.g., 255712345678
    - `checksum` string — If enabled, this is the generated checksum of the payload. Refer to the [documentation](https://docs.clickpesa.com/home/checksum) for more details.

## Response `200`

Initiate Card response

- InitiateCardPaymentResponse
  - `cardPaymentLink` string — A link for a customer to complete payment
  - `clientId` string — Application Client ID associated with the payment

## Other responses

- `400` — Validation Error
- `401` — Invalid or Expired Token
- `404` — Not Found Error
- `409` — Conflict Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/clickpesa/apis/core-api-openapi-specification.md) · [All operations](https://skmtc.dev/clickpesa/apis/core-api-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickpesa/core-api-openapi-specification/revisions/9f70f35c5590/schema)