Payment orchestration made simple

One API for subscriptions and billing

Orkipay sits between your app and payment gateways, giving you a single API for subscriptions, recurring billing, trials, upgrades, multi-country pricing, and more.

View Documentation
const response = await fetch(
  'https://api.orkipay.com/api/v1/subscriptions',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'sk_live_cc91e7dd...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      customerId: 'cust_abc123',
      planPriceId: 'pp_pro_monthly',
      features: [
        { featureId: 'feat_users', quantity: 10 }
      ],
    }),
  }
);

Three steps to production billing

From configuration to automatic billing in minutes

1

Configure

Set up your plans, prices, and payment gateways per country. Define features with quantifiable pricing and trial periods.

2

Subscribe

One API call creates subscriptions with automatic payment processing, trial management, and feature allocation.

3

Manage

Upgrades, downgrades, cancellations, retries, and webhooks — all handled automatically by the state machine.

Everything you need for payment orchestration

Built for teams that need more than a payment gateway SDK

Payment Orchestration

One API, multiple gateways. Connect Stripe, ePayco, or any gateway with a single integration.

Subscription Lifecycle

8-state deterministic state machine handles provisioning, trials, retries, suspensions, and cancellations.

Multi-Country Pricing

Different prices, currencies, trials, and gateways per country. Automatic routing based on customer location.

Feature-Based Pricing

Plans with free, quantifiable, and fixed add-on features. Automatic excess billing per cycle.

Smart Billing

Automatic recurring billing with proration on upgrades and deferred downgrades. Coupon and discount support.

Trial Management

Configurable trial periods per plan-price. Payment method validation upfront. One trial per customer.

Retry Engine

Configurable retry policies for failed payments. Automatic suspension after exhausted retries.

Webhook System

20+ events, HMAC-SHA256 signed, with exponential backoff retry policy. Complete audit trail.

Simple API, powerful results

Create subscriptions, process payments, and receive webhooks with just a few lines of code

typescript
// Create a subscription with one API call
const response = await fetch(
  'https://api.orkipay.com/api/v1/subscriptions',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'sk_live_cc91e7dd...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      customerId: 'cust_abc123',
      planPriceId: 'pp_pro_monthly_co',
      features: [
        { featureId: 'feat_users', quantity: 10 }
      ],
      idempotencyKey: 'create_sub_xyz789',
    }),
  }
);

// Response
{
  "success": true,
  "result": {
    "id": "sub_xyz789",
    "state": "active",
    "currentAmount": "190000",
    "currentPeriodEnd": "2026-04-02T00:00:00Z",
    "plan": { "name": "Pro" },
    "customer": { "externalId": "user_123" }
  }
}

Why Orkipay?

Focus on your product, not billing infrastructure

Don't build billing logic

Orkipay handles the entire subscription lifecycle — retries, proration, state transitions, and more — so you don't have to.

Gateway-agnostic

Switch between payment gateways without changing your code. Start with Stripe, add ePayco for Latin America.

Deterministic states

Every subscription state transition is explicit, auditable, and documented. No surprise states, no undefined behavior.

Multi-tenant by design

Built for platforms serving multiple organizations with complete data isolation and per-org configuration.

Start orchestrating payments today

Get your API key and start building in minutes.

No credit card required