POST
/
api
/
v1
/
pay
/
purchase
curl --request POST \
  --url https://adapter.cepta.co/api/v1/pay/purchase \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Key: <api-key>' \
  --header 'X-Access-Signature: <api-key>' \
  --header 'X-Access-Ts: <api-key>' \
  --data '{
  "transactionRef": "<string>",
  "customerEmail": "<string>",
  "amount": 123,
  "currency": "<string>",
  "ipAddress": "<string>",
  "callbackUrl": "<string>",
  "cardDetails": "<string>",
  "deviceInformation": {
    "httpBrowserLanguage": "<string>",
    "httpBrowserJavaEnabled": true,
    "httpBrowserJavaScriptEnabled": true,
    "httpBrowserColorDepth": "<string>",
    "httpBrowserScreenHeight": "<string>",
    "httpBrowserScreenWidth": "<string>",
    "httpBrowserTimeDifference": "<string>",
    "userAgentBrowserValue": "<string>",
    "deviceChannel": "<string>"
  }
}'
{
  "status": true,
  "message": "<string>",
  "data": {
    "referenceInformationCode": "<string>",
    "responseCode": "<string>",
    "amount": "<string>",
    "transactionRef": "<string>",
    "status": "<string>",
    "submitTimeUtc": "<string>",
    "transactionId": "<string>",
    "transactionId3DSecure": "<string>",
    "eciFlag": "<string>",
    "md": "<string>",
    "accessToken": "<string>",
    "threedSecureUrl": "<string>"
  }
}

Authorizations

​
X-Access-Key
string
header
required

Access key from Dashboard

​
X-Access-Signature
string
header
required

HMAC-SHA256 signature (hex lowercase)

​
X-Access-Ts
string
header
required

Unix timestamp in seconds (UTC) as a string

Body

​
transactionRef
string
required

Unique identifier for the transaction

​
customerEmail
string
required

Email of the customer who made the payment

​
amount
number
required

The payment amount to be paid by customer (must be greater than 0)

​
ipAddress
string
required

IP address of the customer who made the payment

​
currency
string | null

The currency code (e.g., “USD”, “NGN”)

​
callbackUrl
string | null

URL to redirect after payment

​
cardDetails
string | null

Card details of the customer

​
deviceInformation
object

Information about the customer's device

Response

200
text/plain
Success
​
status
boolean

status code

​
message
string | null

Descriptive message about the request result.

​
data
object
Verify Transaction statusValidate transaction OTP