<div id="integration-guide">

<div class="ig-section">
<div class="ig-section-header">
<div class="ig-section-icon" style="background:#f0f7ff;color:#008BB9;"><i class="fas fa-link"></i></div>
<h2>Pay By Link from card machine</h2>
</div>
<p class="ig-section-desc">Already integrated with Teya Card Machines through POSLink? Use your existing credentials to offer Pay By Link, with payments settling into the same store as in-store card machine transactions.</p>

```admonition
icon: fas fa-info-circle
title: Available integrations
content: EPOS Partner credentials support <strong>Pay By Link only</strong>. For other online payment products, register merchants through the partner registration flow instead.
link: /partners/online-payments/register-merchants
```

<!-- Credentials -->
<div class="ig-subsection">
<h3>1. Confirm your credentials</h3>
<div class="ig-flow-steps">
<div class="ig-flow-step"><span class="ig-flow-step-num">1</span> Ensure you have a <strong>company and store</strong> in the Staging environment equivalent to a live setup</div>
<span class="ig-flow-arrow"><i class="fas fa-arrow-right"></i></span>
<div class="ig-flow-step"><span class="ig-flow-step-num">2</span> Confirm you have <strong>POSLink / card machine credentials</strong> for that store</div>
<span class="ig-flow-arrow"><i class="fas fa-arrow-right"></i></span>
<div class="ig-flow-step"><span class="ig-flow-step-num">3</span> Agree with Teya whether PBL will use <strong>EPOS-only</strong> credentials or a dedicated ecommerce store</div>
</div>

<div class="ig-features">
<div class="ig-feature"><i class="fas fa-check"></i> Use your existing <strong>POSLink credentials</strong> (<code>client_id</code> / <code>client_secret</code>)</div>
<div class="ig-feature"><i class="fas fa-check"></i> Payments settle into the <strong>same store</strong> as in-store card machine transactions</div>
<div class="ig-feature"><i class="fas fa-check"></i> No additional ecommerce subscription required</div>
</div>
</div>

<!-- API URLs -->
<div class="ig-subsection">
<h3>2. API URLs</h3>
<table class="ig-comparison">
<thead>
<tr><th>Service</th><th>Staging</th><th>Production</th></tr>
</thead>
<tbody>
<tr><td><strong>Online Payments API</strong></td><td><code>https://api.teya.xyz</code></td><td><code>https://api.teya.com</code></td></tr>
<tr><td><strong>OAuth</strong></td><td><code>https://id.teya.xyz/oauth/v2/oauth-token</code></td><td><code>https://id.teya.com/oauth/v2/oauth-token</code></td></tr>
</tbody>
</table>
</div>

<!-- Scopes -->
<div class="ig-subsection">
<h3>3. Required scopes</h3>
<p>Include these as a space-separated string in your OAuth token request:</p>
<p><code>scope: 'payment-links/create payment-links/id/get payment-links/id/update'</code></p>
<table class="ig-comparison">
<thead>
<tr><th>Scope</th><th>Description</th></tr>
</thead>
<tbody>
<tr><td><code>payment-links/create</code></td><td>Create a payment link</td></tr>
<tr><td><code>payment-links/id/get</code></td><td>Get payment link by ID</td></tr>
<tr><td><code>payment-links/id/update</code></td><td>Update a payment link</td></tr>
</tbody>
</table>
</div>

<!-- Related -->
<div class="ig-subsection">
<h3>Next steps</h3>
<ul>
<li><a href="/partners/online-payments/pay-by-link/api">Pay By Link via API</a> - Create payment links programmatically</li>
<li><a href="/partners/online-payments/webhooks">Webhooks</a> - Receive payment notifications</li>
<li><a href="/partners/online-payments/testing">Testing</a> - Test cards and integration checklist</li>
<li><a href="/apis/online-payments/apis">API Reference</a> - Full API endpoint documentation</li>
</ul>
</div>

</div>
</div>
