Rasedi JavaScript SDK #

Universal Rasedi Payment Gateway SDK for Nodejs, React, Vue, Angular and React Native

Github Repository #

Check the Github Repository for full implementations:

Installation #

npm install rasedi-sdk

Initialization #

Initialize the client with your credentials. Obtain your keys from the Rasedi Dashboard.

import { RasediClient, Gateway, PaymentStatus } from 'rasedi-sdk';

const client = new RasediClient('YOUR_PRIVATE_KEY', 'YOUR_SECRET_KEY');

1. Create a Payment #

Initiate a new payment request. You can specify multiple gateways and various options.

const paymentResponse = await client.createPayment({
  amount: "1050", // Amount in smallest currency unit (e.g., cents or local equivalent)
  title: "Order #12345",
  description: "Premium Subscription Plan",
  gateways: [Gateway.CREDIT_CARD, Gateway.ZAIN], // Specify allowed payment methods
  redirectUrl: "https://your-domain.com/payment/success",
  callbackUrl: "https://your-domain.com/api/webhooks/payment", // For server-to-server notifications
  collectFeeFromCustomer: false,
  collectCustomerEmail: true,
  collectCustomerPhoneNumber: true
});

console.log(`Payment Initiated: ${paymentResponse.body.referenceCode}`);
console.log(`Redirect URL: ${paymentResponse.body.redirectUrl}`);

2. Check Payment Status #

Retrieve the current status of a payment using its unique referenceCode. This is useful for polling or verifying payment completion.

const statusResponse = await client.getPaymentByReference(paymentResponse.body.referenceCode);

if (statusResponse.body.status === PaymentStatus.PAID) {
  console.log("Payment successful!");
} else {
  console.log(`Current Status: ${statusResponse.body.status}`);
}

3. Cancel a Payment #

Cancel a pending payment. This operation is only valid for payments that are still in a PENDING state.

const cancelResponse = await client.cancelPayment(paymentResponse.body.referenceCode);

if (cancelResponse.body.status === PaymentStatus.CANCELED) {
  console.log("Payment successfully canceled.");
}

Enums & Constants #

Gateway #

Supported payment gateways:

Enum Value	Description
Gateway.FIB	First Iraqi Bank
Gateway.ZAIN	ZainCash
Gateway.ASIA_PAY	AsiaPay
Gateway.FAST_PAY	FastPay
Gateway.NASS_WALLET	NassWallet
Gateway.CREDIT_CARD	Credit Card (Visa/Mastercard)

PaymentStatus #

Possible states of a payment:

Enum Value	Description
PaymentStatus.PENDING	Payment created and awaiting user action
PaymentStatus.PAID	Payment successfully completed
PaymentStatus.FAILED	Payment failed or was declined
PaymentStatus.CANCELED	Payment was manually canceled
PaymentStatus.TIMED_OUT	Payment session expired

Examples #

Check the repository for full implementations:

• Angular
• Node.js (Express)
• React
• React Native
• Vue

License #

MIT