For Developers

Payment API Built for Developers

Clear REST API, HMAC authentication, instant webhooks, and real code examples. Start accepting payments in your app.

payment.ts

// Create a payment
const payment = await yallaSystems.createPayment({
  amount: 1500.00,
  currency: 'EGP',
  method: 'card',
  customer: {
    name: 'Ahmed Hassan',
    email: '[email protected]'
  },
  callbackUrl: 'https://yourapp.com/callback',
  webhookUrl: 'https://yourapp.com/webhook'
});

// Check status
const status = await yallaSystems.getPaymentStatus(
  payment.id
);
// → 'success' | 'pending' | 'failed'

API Features

REST API

Clear, easy-to-use RESTful interface.

Webhooks

Instant notifications when payment status changes.

HMAC Auth

Secure HMAC signature authentication for every request.

Fast Response

Low response time for transactions.

Integration Steps

Get your API key

Create a payment

Call the create payment endpoint with amount and customer details.

Receive webhook

Receive a webhook notification when payment completes and verify the signature.

Verify status

Call the payment status endpoint for final confirmation.

FAQ

What is a Payment API?

A Payment API is a programmatic interface that allows developers to integrate a payment gateway into their websites and apps, enabling payment creation, status checking, and webhook notifications.

How do I integrate with Yalla Systems API?

Get your API key from the dashboard, use it in the Authorization header for every request, then call the create payment endpoint. Receive payment results via webhook or redirect.

Is the API secure?

Yes, all API requests are encrypted and use HMAC authentication. Card details are never stored on your servers.

How do I check payment status?

You can check payment status by calling the transaction status endpoint, or receive automatic webhook notifications when the status changes.

Start Integrating Now

Clear documentation, code examples, and a ready sandbox environment.

Read the Docs