Prerequisites
- An Orchestra account (sign up here)
- A payment gateway account with API credentials
Add a Provider
Navigate to Payment Gateway Accounts
In the Orchestra portal, go to Resources > Payment Gateway Account > Create.
Configure the Connection
Fill in the required fields:
| Field | Description |
|---|---|
| Name | A unique identifier for this gateway account (e.g., “stripe-test”, “adyen-production”). Used in API calls to specify which gateway to use. |
| Username | (Create only) Optionally assign this gateway account to a specific user. If blank, the account is available to all users. |
| Payment Gateway Name | Select your payment provider from the dropdown |
| Credentials | Provider-specific fields appear after selecting a gateway. Enter your API credentials from your gateway’s dashboard. |
The credentials fields change based on the gateway you select. Common fields include API keys, terminal IDs, merchant IDs, and secret keys.
Gateway Credentials
Each gateway requires different credentials. Here are examples for common providers:Stripe
Stripe
- API Key: Your Stripe secret key (starts with
sk_test_orsk_live_)
Adyen
Adyen
- Merchant Account: Your merchant account name
- Username and Password: Your Adyen username and password
- Company Name: Your company name in Adyen
Worldpay
Worldpay
- SecurenetId: Your unique merchant identifier for WorldPay’s API.
- SecureNetKey: Your API authentication key for WorldPay backend configurations.
Test vs Production Credentials
Most gateways provide separate test and production credentials:| Environment | Use For |
|---|---|
| Test/Sandbox | Development, testing, CI/CD |
| Production/Live | Real customer transactions |