# Orchestrapay - Payment Orchestration & Merchant of Record

Orchestrapay is a payment orchestration platform. Integrate one API and accept
payments through 120+ gateways and local payment methods across 100+ countries.
Orchestrapay intelligently routes every transaction for the lowest cost, the
highest acceptance rate, and automatic failover. As a secondary offering, it
acts as merchant of record in Egypt, Nigeria, and Kenya: it processes payments
on the local rails and pays your revenue out internationally, so you never
connect to the local processors yourself.

- Website: https://www.orchestrapay.com
- Documentation: https://docs.orchestrapay.com
- API base URL: https://api.orchestrapay.com
- OpenAPI spec: https://www.orchestrapay.com/openapi.json
- Current API version: 202607

## What Orchestrapay does

- **Payment orchestration** - one integration, many gateways. Smart routing picks
  the best provider per transaction for cost, acceptance, and reliability, with
  automatic failover.
- **Merchant of record (Egypt, Nigeria, Kenya)** - Orchestrapay processes your
  payments on the local rails and pays your revenue out internationally
  (USD/EUR). No local entity, license, or local-rail integrations needed.
- **Payment methods** - cards, digital wallets, mobile money, bank transfers,
  BNPL, and cash on delivery.
- **Recurring billing** - subscriptions, plans, invoices, coupons, promotion
  codes, and a hosted billing portal.
- **Embeddable checkout** - hosted and in-page payment forms via the
  `@orchestrapay/react` SDK; PCI-compliant iframe fields.

## Quickstart for agents and developers

1. Create an account and generate an API key (self-serve):
   https://www.orchestrapay.com/auth/signup
2. Authenticate: `Authorization: Bearer orch_sk_test_eu1_...` (test) or
   `orch_sk_live_eu1_...` (live). Full walkthrough: https://www.orchestrapay.com/auth.md
3. Call the API at https://api.orchestrapay.com with a version prefix, e.g.
   `POST /v202607/payment-intents`.
4. Or install an SDK:
   - Node.js: `npm install @orchestrapay/sdk`
   - React: `npm install @orchestrapay/react`

## Example: create a payment intent

```bash
curl https://api.orchestrapay.com/v202607/payment-intents \
  -H "Authorization: Bearer $ORCHESTRAPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1999, "currency": "usd"}'
```

## Key resources

| Resource | URL |
| --- | --- |
| OpenAPI spec | https://www.orchestrapay.com/openapi.json |
| Authentication guide | https://www.orchestrapay.com/auth.md |
| Pricing (markdown) | https://www.orchestrapay.com/pricing.md |
| llms.txt index | https://www.orchestrapay.com/llms.txt |
| Docs | https://docs.orchestrapay.com |
| GitHub | https://github.com/orchestrapay |

## When to use Orchestrapay

Use Orchestrapay to accept, orchestrate, or reconcile payments; to sell into
Egypt, Nigeria, or Kenya without local-rail integrations (via merchant of
record); to manage subscriptions and refunds; or to embed a checkout. It is not
a generic banking, KYC, or ledger API.

## Contact

- Sales & demos: sales@orchestrapay.com
- Privacy: privacy@orchestrapay.com
- Legal: legal@orchestrapay.com
- Orchestrapay, LLC, 28 Geary St, Suite 650 #352, San Francisco, CA 94108, United States