Installation

Install and configure the OpenFacilitator SDK.

Package Manager

# npm
npm install @openfacilitator/sdk
 
# yarn
yarn add @openfacilitator/sdk
 
# pnpm
pnpm add @openfacilitator/sdk

Configuration

import { OpenFacilitator } from '@openfacilitator/sdk';
 
// Uses https://pay.openfacilitator.io by default
const facilitator = new OpenFacilitator();
 
// Or configure with options
const customFacilitator = new OpenFacilitator({
  // Custom facilitator URL
  url: 'https://pay.yourdomain.com',
 
  // Optional: Request timeout (default: 30000ms)
  timeout: 30000,
 
  // Optional: Custom headers
  headers: {
    'X-Custom-Header': 'value',
  },
});

TypeScript

The SDK is written in TypeScript and includes full type definitions:

import type {
  PaymentPayload,
  PaymentRequirements,
  VerifyResponse,
  SettleResponse,
  SupportedResponse
} from '@openfacilitator/sdk';