Verify Transaction Status

Transaction statuses

When verifying a transaction status, we have a defined status type that you can expect to see here.

Transaction Status Type	Description
`pending`	The transaction is awaiting processing or validation. This could indicate invalid request parameters or that the transaction is in a holding state.
`successful`	The transaction was successfully processed, The payment has been completed without issues.
`failed`	The transaction encountered an error during processing, possibly due to insufficient funds, incorrect details, or a technical failure.
`reversed`	The transaction was reversed due to an error, which could include issues like a duplicate payment, invalid card details, or a technical failure in processing.

Verify transaction endpoint

Make an API call to this endpoint to verify pay/verify-payment?TransactionRef. pass a transactionRef as a query string to the endpoint.

Request
curl --request GET \
  --url https://adapter.cepta.co/api/v1/pay/verify-payment?TransactionRef={ TransactionRef } \
  --header 'Authorization: <SECRET_KEY>' \
  --header 'Content-Type: application/json' \

Request body

order

object

required

Account reference

TransactionRef

string

required

Unique reference for the transaction.

Verify transaction status response

Success response
{
  "status": true,
  "message": "Transaction verified successfully.",
  "data": {
    "amount": 100,
    "chargedAmount": 105,
    "currency": "USD",
    "customerEmail": "[email protected]",
    "narration": "Payment for order #12345",
    "status": "Paid",
    "responseCode": "00",
    "transactionRef": "ada",
    "processorResponse": "Payment completed successfully.",
    "createdAt": "2024-11-29T12:22:27.891Z",
    "paidAt": "2024-11-29T12:22:27.891Z",
    "ip": "192.168.1.1",
    "paymentType": "Card",
    "fees": 5,
    "meta": "{}",
    "message": "Payment processed."
  }
}

Handling Verify transaction status response

status

boolean

Indicates if the request was successful.

message

string

Descriptive message about the request result.

data

object

amount

number

Original payment amount

chargedAmount

number

Amount charged to the customer

currency

string

Currency of the transaction (e.g., “USD”).

customerEmail

string

Email of the customer who made the payment

narration

string

Description or narrative of the payment

status

string

Current status of the transaction (e.g., “Paid”)

responseCode

string

Reference for the created transaction.

processorResponse

string

Reference for the created transaction.

createdAt

string

Reference for the created transaction.

paidAt

string (ISO 8601)

Reference for the created transaction.

string

IP address from which the payment was made.

paymentType

string

Type of payment method used (e.g., “Card”).

fees

string

Fees charged for the transaction

Welcome To Cepta

Setup Cepta

Product

Guide

Advanced Concepts

Verify Transaction Status

Transaction statuses

Verify transaction endpoint

Request body

Verify transaction status response

Handling Verify transaction status response

Welcome To Cepta

Setup Cepta

Product

Guide

Advanced Concepts

​Transaction statuses

​Verify transaction endpoint

​Request body

​Verify transaction status response

​Handling Verify transaction status response

Transaction statuses

Verify transaction endpoint

Request body

Verify transaction status response

Handling Verify transaction status response