API Providers Setup Guide

Infrastructural API Connectivity

Connecting API Providers is essential for the core functioning of your platform, enabling you to process credit cards, deliver transactional emails, and send SMS OTPs. Note that you can only have one active payment provider connected at a time.

---

1. Payment Gateways

Orbitus supports Stripe (Global), PayTR (Turkey), and Iyzico (Turkey & MENA) out of the box.

Stripe Configuration

1. Log into your Stripe Dashboard.
2. Enable "Test Mode" if you want to perform sandboxed transactions, or leave it off for Production.
3. Go to the Developers > API keys tab.
4. Reveal your Secret Key (starts with sk_live_ or sk_test_) and copy your Publishable Key (starts with pk_live_).
5. In Orbitus > Integrations > Payment, select "Stripe" from the tabs. Paste both keys.
6. Optional Webhooks: In Stripe, navigate to Webhooks. Add an endpoint pointing to https://yourdomain.com/api/webhooks/stripe. Copy the Signing Secret (whsec_...) and paste it into the "Webhook Secret" field in Orbitus.
7. Click Test Connection and save.

PayTR Configuration

1. Log into the PayTR Merchant Store.
2. Navigate to the Information (Bilgiler) section.
3. You will need three exact keys: Merchant ID, Merchant Key, and Merchant Salt.
4. In Orbitus > Integrations > Payment, select "PayTR".
5. Paste the ID, Key, and Salt exactly as generated. Test and save.

Iyzico Configuration

1. Log into your Iyzico Control Panel (or sandbox.iyzipay.com for testing).
2. Navigate to Settings > Provider Credentials.
3. Copy both the API Key and the Secret Key.
4. In Orbitus, select "Iyzico", paste the keys, and check "Sandbox Mode" if using development credentials. Test and save.

---

2. Email Provider Configuration

Connect SMTP or native HTTP API providers (like Resend, SendGrid, Amazon SES) to vastly improve your email deliverability rates.

Configuration interface may vary. Typically requires Host, Port, Username, and Password for SMTP connections, or an Authorizer API Key for platforms like Resend.

---

3. SMS Provider Configuration

Connect OTP and bulk SMS providers to send text messages globally.

Navigate to Integrations > SMS. Depending on your installed provider driver (e.g., Twilio, Netgsm), you will require an Account SID/ID and an Auth Token/Secret. Ensure your Sender ID (Alphanumeric Originator) is approved by the carrier before sending live messages.