Payment Validator

Validate payment initiation requests against CBUAE Open Finance and ISO 20022 standards with IBAN, amount, and routing checks

Category: Open FinanceEndpoint: /v1/openfinance/payment/validate

Avg Response

<50ms

Uptime SLA

99.99%

Free Tier

1,000/mo

Quick Start

JavaScript / TypeScript

javascript

import { KhaleejiAPI } from '@khaleejiapi/sdk';
 
const client = new KhaleejiAPI('your_api_key');
 
const result = await client.request('/v1/openfinance/payment/validate', {
  method: 'POST',
  body: {
    payment: {
      payerIBAN: 'AE070331234567890123456',
      payeeIBAN: 'AE460261234567891234567',
      amount: 1500.00,
      currency: 'AED',
      purpose: 'domestic_payment',
      paymentType: 'instant',
      beneficiaryName: 'Dubai Trading LLC',
      consentId: 'consent-abc-123',
      endToEndId: 'E2E-2025-001',
    }
  }
});
 
console.log(result.compliant); // true
console.log(result.classification.paymentScheme); // "IPP (Aani)"

Python

python

from khaleejiapi import KhaleejiAPI
 
client = KhaleejiAPI('your_api_key')
 
result = client.request('/v1/openfinance/payment/validate', method='POST', json={
    'payment': {
        'payerIBAN': 'AE070331234567890123456',
        'payeeIBAN': 'AE460261234567891234567',
        'amount': 1500.00,
        'currency': 'AED',
        'paymentType': 'instant',
        'consentId': 'consent-abc-123',
    }
})
 
print(f"Compliant: {result['compliant']}")
print(f"Scheme: {result['classification']['paymentScheme']}")

cURL

curl

curl -X POST "https://khaleejiapi.dev/api/v1/openfinance/payment/validate" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"payment":{"payerIBAN":"AE070331234567890123456","payeeIBAN":"AE460261234567891234567","amount":1500,"currency":"AED","paymentType":"instant","consentId":"consent-abc-123"}}'

Get Your API Key View Documentation

Related APIs

Participants Directory

Directory of UAE Licensed Financial Institutions under the CBUAE Open Finance Framework with phase, status, and product filtering

Consent Validator

Validate consent objects against CBUAE Article 22 — purpose specificity, time bounds, data privacy, and withdrawal requirements

Standards Reference

CBUAE Open Finance standards, compliance deadlines, release roadmap, and technical specifications for building compliant integrations

Consent Validator Standards Reference

Back to all APIs