---
title: "Card Payment API"
method: POST
path: "/api/v3/purchases"
---

# Card Payment API

`POST /api/v3/purchases`

## Request

- Base URL: `https://sandbox.interswitchng.com`
- URL: `https://sandbox.interswitchng.com/api/v3/purchases`
- Auth: none required

## Headers

- `Authorization` string
- `Content-Type` string

## Request body

- object
  - `customerId` string, required: Unique identifier for the customer
  - `amount` string, required: The amount being paid. This is usually in the smallest currency unit (e.g Naira)
  - `transactionRef` string, required: Unique transaction reference per transaction.
  - `currency` string, required: Currency being used.
  - `authData` string, required: Combination of the sensitive data of the payment (PAN, PIN, Expiry Date, and CVV2)
  - `deviceInformation` string, json: It is compulsory to collect device information from the user's browser and include it in the payment request.

## Response `200`

200

- object
  - `transactionRef` string
  - `paymentId` string
  - `message` string
  - `amount` string
  - `responseCode` string
  - `plainTextSupportMessage` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/interswitchgroup/apis/accept-payment.md) - [All operations](https://skmtc.dev/interswitchgroup/apis/accept-payment/llms.txt) - [OpenAPI document](https://skmtc.dev/interswitchgroup/apis/accept-payment/revisions/1b127ee04f2f?raw)