Migrating from RPG & SecurePay
If your website or systems have been taking online card payments through Borgun — or through Teya before the new platform — this section is for you. You may know the old setup as "the Borgun payment page", SecurePay, RPG, the Borgun Payment API, B-Gateway or the Ticket API; whichever name you recognise, find the row below that describes how you take payments today. That is your guide.
What is changing
Teya's legacy online payment systems — the Borgun payment page (SecurePay), the Borgun payment API (RPG), the B-Gateway web service and the Ticket API — continue to work as normal today, and nothing changes for you right now. Onboarding to those systems will stop soon, and they will be retired in early 2027. Before then, your integration needs to move to the new Teya online payments platform.
The right route depends on your current setup. The effort varies from nothing at all (if you sell through a partner platform) to a small development project, typically days including testing. Every path below is live today and can be started immediately.
Find your path
If more than one row applies — a webshop checkout and payment links, for example — migrate each with its own guide.
| How you take payments today | Typical signs | Your migration path |
|---|---|---|
| Customers are redirected to a SecurePay payment page | Your site posts a form to securepay.borgun.is; your developer set up a "payment form post" with a checkhash |
SecurePay → Hosted Checkout — the like-for-like path: lowest effort, same redirect experience for your customers |
| The SecurePay payment form is embedded in your own checkout | displaymode=iframe in your integration; customers pay without leaving your site |
SecurePay → Embedded Components — keeps the payment form on your page (Hosted Checkout can't) |
| You redirect to SecurePay but want an on-site checkout | You care about checkout conversion and branding, or want Apple Pay on your own page | SecurePay → Embedded Components — read its "which is right for you" section first |
| Your systems call the RPG payment API directly | Code calling /api/payment on borgun.is; a private access token; your own 3D Secure (MPI) integration |
RPG → Embedded Components |
| Your systems call the B-Gateway web service | SOAP/XML requests such as getAuthorization to gateway01.borgun.is; a B-Gateway username and password; card numbers or virtual card numbers (9910…) reach your own servers; often no 3D Secure. Also known as BGateway or Greiðslugátt |
B-Gateway → Embedded Components: card numbers no longer pass through your systems |
| You create payment URLs and send them to customers | Payment links made in advance for email, phone or invoice orders (the Ticket API) | Ticket API → Payment Links — often no code at all; links can be created in the Business Portal |
| You store customers' cards or take recurring payments | Multi-use tokens (tm_…) or virtual card numbers (16 digits starting 9910); subscriptions or instalments charged when the customer isn't present |
Migrate your one-off payments first with the row that matches you, then follow Stored cards & recurring — your customers' saved cards carry over without re-entering a card |
| You sell through a partner platform | A booking system, webshop provider or till system built the integration — you never did | The preparation is managed for you by your platform provider. Watch for their instructions — you may need to reconnect your store or sign in again when the switch happens. If in doubt, ask them or your Teya contact. |
| You use a Teya plugin for WooCommerce or Shopify | A Teya or Borgun plugin installed in your shop admin | Install the current Teya plugin and connect it to your Teya account — see Connect with e-commerce platforms and Set up and connect your plugin to Teya in the Help Centre. Watch for instructions from Teya; you may need to sign in again when your store switches over. |
borgun.is?" "Do we send JSON to /api/payment, or XML such as getAuthorization?" — JSON is RPG, XML is B-Gateway. Between them, the answers place you in one row. Still unsure? Contact your Teya account manager and we'll look at your setup together.
What you gain
This is more than a platform change. The new platform was built from the ground up and removes the most dated parts of the legacy integrations.
Migration guides
Every guide has the same shape: a short first part for the business owner — why, what you gain, what to send your developer — and a developer guide with how it works before and after, a table of what replaces what, and the migration steps.
SecurePay → Hosted Checkout
The like-for-like path
One server-side call replaces the signed form post; your customer still pays on a Teya page and comes back to your site.
Lowest effortSecurePay → Embedded Components
Keep the checkout on your site
For iframe integrations, or for anyone who wants an on-site checkout with Apple Pay. Includes a Hosted Checkout comparison.
Some codeRPG → Embedded Components
For direct API integrations
Replace /api/payment and your MPI calls with a checkout session and a component; 3D Secure is handled for you.
B-Gateway → Embedded Components
For SOAP/XML integrations
Replace getAuthorization, your card form and any 3D Secure flow with a checkout session and the Checkout component; save cards for subscriptions and charge them by API.
Ticket API → Payment Links
For pre-created payment URLs
Create links in the Business Portal or by API, get paid by webhook.
No code optionStored cards & recurring
Do this after your one-off payments
Your customers' saved cards move to the new platform without anyone re-entering a card. Four phases, no bulk conversion on your side.
Reference: what replaces what
- Migrating from SecurePay - Every SecurePay form parameter and its replacement on the new platform
- Migrating from RPG - Every RPG endpoint and its replacement
- Migrating from B-Gateway - Every B-Gateway operation and field and its replacement
Whichever path you take
Next steps
- Online payments overview - The new platform's integration options side by side
- Authenticate - Create API credentials in the Business Portal
- Testing - Test cards and integration checklist
- Webhooks - Receive and verify payment notifications
- Migrate with an AI assistant - Prompts and a downloadable pack for LLM-assisted migrations
- Migration FAQ - Timelines, what changes for your customers, what is different