API Providers Setup Guide
Detailed guide to configuring foundational API providers: Payment Gateways (Stripe, PayTR, Iyzico), Email delivery services, and SMS providers. Learn where to find secret keys and how to test the connections safely.
Last updated: 04/14/2026, 10:12 AM
<div class="features-wrapper">
<h2>Infrastructural API Connectivity</h2>
<p>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 <strong>one active payment provider</strong> connected at a time.</p>
<hr>
<h2>1. Payment Gateways</h2>
<p>Orbitus supports Stripe (Global), PayTR (Turkey), and Iyzico (Turkey & MENA) out of the box.</p>
<h3>Stripe Configuration</h3>
<ol>
<li>Log into your <a href="https://dashboard.stripe.com" target="_blank">Stripe Dashboard</a>.</li>
<li>Enable "Test Mode" if you want to perform sandboxed transactions, or leave it off for Production.</li>
<li>Go to the <strong>Developers > API keys</strong> tab.</li>
<li>Reveal your Secret Key (starts with <code>sk_live_</code> or <code>sk_test_</code>) and copy your Publishable Key (starts with <code>pk_live_</code>).</li>
<li>In Orbitus > Integrations > Payment, select "Stripe" from the tabs. Paste both keys.</li>
<li><strong>Optional Webhooks:</strong> In Stripe, navigate to Webhooks. Add an endpoint pointing to <code>https://yourdomain.com/api/webhooks/stripe</code>. Copy the Signing Secret (<code>whsec_...</code>) and paste it into the "Webhook Secret" field in Orbitus.</li>
<li>Click <strong>Test Connection</strong> and save.</li>
</ol>
<h3>PayTR Configuration</h3>
<ol>
<li>Log into the <a href="https://www.paytr.com/magaza" target="_blank">PayTR Merchant Store</a>.</li>
<li>Navigate to the <strong>Information (Bilgiler)</strong> section.</li>
<li>You will need three exact keys: <strong>Merchant ID</strong>, <strong>Merchant Key</strong>, and <strong>Merchant Salt</strong>.</li>
<li>In Orbitus > Integrations > Payment, select "PayTR".</li>
<li>Paste the ID, Key, and Salt exactly as generated. Test and save.</li>
</ol>
<h3>Iyzico Configuration</h3>
<ol>
<li>Log into your <a href="https://merchant.iyzipay.com" target="_blank">Iyzico Control Panel</a> (or sandbox.iyzipay.com for testing).</li>
<li>Navigate to Settings > Provider Credentials.</li>
<li>Copy both the <strong>API Key</strong> and the <strong>Secret Key</strong>.</li>
<li>In Orbitus, select "Iyzico", paste the keys, and check "Sandbox Mode" if using development credentials. Test and save.</li>
</ol>
<hr>
<h2>2. Email Provider Configuration</h2>
<p>Connect SMTP or native HTTP API providers (like Resend, SendGrid, Amazon SES) to vastly improve your email deliverability rates.</p>
<p><em>Configuration interface may vary. Typically requires Host, Port, Username, and Password for SMTP connections, or an Authorizer API Key for platforms like Resend.</em></p>
<hr>
<h2>3. SMS Provider Configuration</h2>
<p>Connect OTP and bulk SMS providers to send text messages globally.</p>
<p><em>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.</em></p>
</div>