Get Session

Retrieve the full details of a checkout session, including merchant info and enabled payment methods.

GET /v1/checkout/session/:sessionId

Required permission: checkout

Authentication

Requires an API key (public or secret). Origin/domain validation is enforced for public keys.

Path parameters

Parameter	Type	Description
sessionId	string	The checkout session ID

Example request

cURL

curl https://api.zevpaycheckout.com/v1/checkout/session/ecc48011-e36e-4741-9b99-657f4a1ee86e \
  -H "x-api-key: pk_test_your_public_key"

Node.js

const response = await fetch(
  'https://api.zevpaycheckout.com/v1/checkout/session/ecc48011-e36e-4741-9b99-657f4a1ee86e',
  {
    headers: {
      'x-api-key': 'pk_test_your_public_key',
    },
  }
);

const { data } = await response.json();
console.log(data.status); // "active"

Python

import requests

response = requests.get(
    "https://api.zevpaycheckout.com/v1/checkout/session/ecc48011-e36e-4741-9b99-657f4a1ee86e",
    headers={"x-api-key": "pk_test_your_public_key"},
)

data = response.json()["data"]
print(data["merchant_name"])

Response

{
  "success": true,
  "data": {
    "session_id": "ecc48011-e36e-4741-9b99-657f4a1ee86e",
    "amount": 500000,
    "currency": "NGN",
    "customer_email": "customer@example.com",
    "customer_name": null,
    "merchant_name": "Acme Store",
    "enabled_payment_methods": ["bank_transfer", "payid"],
    "callback_url": "https://merchant.com/payment/callback",
    "expires_at": "2026-03-07T19:37:00.000Z",
    "status": "active"
  }
}

Field	Type	Description
session_id	string	The checkout session ID
amount	integer	Amount in kobo
currency	string	Currency code (e.g., "NGN")
customer_email	string	Customer's email address
customer_name	string | null	Customer's name (if provided)
merchant_name	string | null	Merchant's business name from checkout configuration
enabled_payment_methods	string[]	Available payment methods for this session
callback_url	string | null	URL to redirect after payment (standard checkout)
expires_at	string	ISO 8601 timestamp when the session expires
status	string	Current session status: active, completed, expired, or failed

Behavior

• If the session is active but past its expires_at time, the status is automatically updated to expired
• This endpoint is used by the checkout UI to render session details

Errors

Status	Message	Cause
404	Session not found.	Invalid session ID
401	Invalid API key	Key not found or inactive

Try it

API Playground

GEThttps://api.zevpaycheckout.com/v1/checkout/session/:sessionId

API Key Stored locally in your browser

Path Parameters

sessionId *