Prerequisites
- An Orchestra account (sign up here)
- A payment gateway account with API credentials
Add a Provider
1
Navigate to Payment Gateway Accounts
In the Orchestra portal, go to Resources > Payment Gateway Account > Create.
2
Configure the Connection
Fill in the required fields:
| Field | Description |
|---|---|
| Name | A friendly identifier you’ll use in API calls (e.g., “StripeTest”, “Adyen_Production”) |
| Username | Select to assign this account to your user or restrict this account to a specific user |
| Payment Gateway Name | Select your payment provider from the dropdown |
| Credentials | Enter the API credentials for your gateway |
The credentials fields change based on the gateway you select. Common fields include API keys, terminal IDs, merchant IDs, and secret keys.
3
Save
Click Save. Your provider is now connected and ready for transactions.
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 |