Transaction Verification API

Automate and validate digital banking transactions inside your application pipeline. The Yegna Pay verification engine protects your system against fraud, checks totals, and confirms user data instantly.

Authentication

Authenticate your API requests using Bearer tokens included in the Authorization header. You can manage your API keys from the developer dashboard.

API Endpoint

Parameters Schema

Request Examples

boacbeawash

Mock Payload Data

jsonCopy Code

{
  "full_name": "JOHN DOE ENTERPRISE",
  "price_amount": "4000",
  "platform": "CBE",
  "currency": "ETB",
  "transaction_id": "-2KCLVVWOY3-4R75E0"
}

How to Send Requests

Integrate Yegna Pay effortlessly. Copy the ready-to-use snippets below to implement the transaction POST request in your preferred programming language.

const url = 'https://yegna-pay-api.vercel.app/api/transaction/create';
const token = 'sk_live_...';

const payload = {
  full_name: "MULUGETA KASSAW CLEANING SERVICE",
  price_amount: "4000",
  platform: "awash",
  currency: "ETB",
  transaction_id: "-2KCLVVWOY3-4R75E0"
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify(payload)
})
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));

Expected Response

Upon a successful verification query, the Yegna Pay API will respond with a JSON payload validating the status and extracted payment amount.

{
  "success": true,
  "data": {
    "verified": true,
    "amount": 4000,
    "platform": "CBE",
    "transaction_id": "-2KCLVVWOY3-4R75E0",
    "timestamp": "2026-06-12T01:17:00Z"
  }
}

The Verification Pipeline

Best Practices