---
updatedAt: 2026-02-26T13:10:43.000Z
agentTools:
  projectIndex: https://docs.ksa.ngenius-payments.com/llms.txt
---

# Direct API

N-Genius Online REST JSON APIs

#### 🧭 Direct API Overview

Welcome to the N-Genius Online Direct API Integration section. Here, you'll find all the tools, steps, and support needed to integrate our robust RESTful JSON APIs into your environment.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/326df9ff957a252fc1f6f694f095ae782659fdb354dd0f50f6a9524c7b65786b-n-genius-direct-api-flow.png",
        "",
        "Flowchart diagram showing the N-Genius Direct API integration steps: Access Token → Payment Request (One-Stage or Two-Stage) → 3DS Authentication (optional) → Order Status Retrieval → Capture → Refund/Reversal (if needed)"
      ],
      "align": "center",
      "caption": "N-Genius Direct API Flow – From authentication to refunds, this flowchart outlines the typical integration journey for merchants seeking full control over their checkout experience."
    }
  ]
}
[/block]

Our Direct API is ideal for merchants and partners seeking **full control** over their payment experience — including support for <<glossary:Tokenization>>, <<glossary:3-D Secure>>, refunds, reversals, and more.

> **Note:** Direct API integration requires **[PCI-DSS compliance](https://docs.ngenius-payments.com/docs/pci-dss)** since it involves directly capturing and transmitting sensitive card data.

***

### 🗺️ Get Started Quickly

Jump to the most commonly used endpoints and flows:

* 🔐 [Request Access Token](https://docs.ngenius-payments.com/reference/request-an-access-token-direct)
* 💳 [One-Stage Payments (PURCHASE)](https://docs.ngenius-payments.com/reference/one-stage-payments-1)
* 🔄 [Two-Stage Payments (AUTH + CAPTURE)](https://docs.ngenius-payments.com/reference/two-stage-payments-orders)
* 🔎 [Retrieve Order Status](https://docs.ngenius-payments.com/reference/retrieve-order-status)
* 🔁 [Refund a Capture](https://docs.ngenius-payments.com/reference/refund-a-capture-1)
* 🧩 [EMV 3DS Integration Guide](https://docs.ngenius-payments.com/reference/emv-3ds-3ds-2x-integration-2) (with interactive Recipe)

***

### 🧪 Postman Collection

To accelerate your integration:

* Download the [N-Genius Online Direct API](https://www.postman.com/network-developers/ngeniusdev/collection/jpu6n1m/n-genius-online-direct-api) Postman collection.
* Includes preconfigured headers, requests, dynamic variables, and test responses
* Import it to get started in minutes!

***

### 🛠️ Developer Tools

* 📊 [Status Codes](https://docs.ngenius-payments.com/reference/error-codes-details) and State Transitions Guide
* 📘 [Full API Reference](https://docs.ngenius-payments.com/reference/generateaccesstoken)
* 📥 Sandbox vs Production Configuration Tips

***

### 🚀 Quick Note on Recipes

Use our step-by-step Recipes embedded throughout the site for key flows like EMV 3DS Authentication and Two-Stage Payments — designed to reduce errors and simplify onboarding.