sóley

Connect your payment processor

A step-by-step guide to connecting your own card processor to Sóley. Find your processor below — most operators use Teya.

You never register a webhook or open a developer dashboard. Once your keys are saved, Sóley confirms each payment automatically by checking with your processor. Setup is just pasting the keys below.
You stay the merchant of record. Travelers pay you directly through your own processor; Sóley never holds your funds and invoices its 10% commission separately.
Teya / Borgun (SecurePay) — RecommendedStraumur (Kvika)Rapyd / Valitor / Korta

Teya / Borgun (SecurePay)Recommended

Teya (formerly Borgun) is the most common card processor for Icelandic operators. You connect it with the credentials from your SecurePay welcome email — no dashboard setup needed.

Steps

  1. 1Find the SecurePay welcome email Teya/Borgun sent when your account was set up (the subject usually mentions 'SecurePay' or 'Borgun').
  2. 2If you can't find the email, sign in to the Teya merchant portal at teya.com and open Settings → Merchant / Online payments.
  3. 3Copy the three values below into Sóley exactly as they appear — no extra spaces.
  4. 4Leave the environment on Sandbox, save, and test. Switch to Production when you're ready for real payments.

What to paste

Merchant ID
A numeric merchant number, near the top of the welcome email (also shown in the Teya portal under your merchant).
Payment gateway ID
A short number in the same email, often labelled 'Gateway' or 'Web payment gateway'.
SecurePay secret key
The secret/shared key in the welcome email. Treat it like a password; never share it.

Straumur (Kvika)

Straumur (Kvika) is the one processor with a couple of extra steps: besides your API key and terminal id, you copy a signing secret and register one callback URL so we learn when a payment completes. It's still doable in a few minutes — follow the steps below. (Most operators use Teya, which skips all of this.)

Steps

  1. 1Sign in to the Straumur merchant dashboard at portal.straumur.is.
  2. 2Go to Settings → API keys and copy the secret API key (not the public one). Paste it into Sóley's 'API key' field.
  3. 3Go to Terminals and copy your 12-character terminal identifier (the same id printed on your card terminal). Paste it into 'Terminal identifier'.
  4. 4Go to Webhooks / Notifications and copy the signing secret (a long hex string). If none exists yet, create one. Paste it into 'Webhook HMAC secret'.
  5. 5Still under Webhooks / Notifications, add a notification/webhook and paste the callback URL Sóley shows you in the 'Register this callback URL' box on the payment step. Save it in the Straumur dashboard.
  6. 6Back in Sóley, keep the environment on Sandbox and save. Run one test booking — when it confirms, switch to Production and paste your live keys + register the production callback URL the same way.

What to paste

API key
Settings → API keys. The secret key, not the public one.
Terminal identifier
Terminals. Exactly 12 characters.
Webhook HMAC secret
Webhooks / Notifications → signing secret. A long hex string.
Callback URL (you register it)
Webhooks / Notifications → add a notification → paste the URL from Sóley's 'Register this callback URL' box.

Rapyd / Valitor / Korta

Rapyd (which also powers Valitor and Korta) uses an access key and a secret key from the Rapyd Client Portal.

Steps

  1. 1Sign in to the Rapyd Client Portal.
  2. 2Open Developers → Credentials.
  3. 3Copy the Access key.
  4. 4Copy the Secret key. Important: Rapyd shows the secret only once, at creation — if you've lost it, create a new key pair.
  5. 5Use Sandbox keys to test and Production keys for real payments — they are different keys in the portal.

What to paste

Access key
Developers → Credentials → Access key.
Secret key
Shown next to the Access key. Visible only once, at creation.

Sandbox vs Production

Every processor gives you two sets of keys. Sandbox (test) keys let you run fake payments to make sure everything is wired up — no real money moves. Production (live) keys take real card payments.

  1. 1Start in Sandbox. Paste your test keys and save.
  2. 2Run a test booking end to end to confirm the payment link opens and completes.
  3. 3When it works, switch the Environment dropdown to Production and paste your live keys.
  4. 4Do one small real booking to confirm the money lands in your account.

How do I know it worked?

After you save, Sóley checks the keys with your processor:

  • •Saved and verified (green) — your keys are correct and Sóley reached your processor. You're done.
  • •Saved, couldn't verify (amber) — the keys are stored but we couldn't reach the processor right now (often a temporary network blip). Re-check later, or run a test booking.
  • •Error (red) — the keys were rejected. Re-copy them carefully and check you didn't mix Sandbox and Production keys.

Once verified in Production and your listing is live, the payment step on your go-live checklist shows as complete.

Troubleshooting

It says the credentials are wrong.

Re-copy each value with no leading or trailing spaces. Secrets are case-sensitive. Make sure you copied the secret key, not the public/access key.

Sandbox worked but Production doesn't.

Sandbox and Production use different keys. Switch the Environment dropdown to Production and paste the live keys from your processor.

The payment didn't confirm after the traveler paid.

Sóley confirms automatically by checking with your processor, so give it a moment and refresh — confirmation usually lands within seconds. If it stays unconfirmed, double-check the keys are the live (Production) keys. For Straumur, also check the signing secret is correct.

I lost my Rapyd secret key.

Rapyd shows it only once. Create a new key pair in Developers → Credentials and paste the new Access + Secret keys.

I can't find my keys at all.

Contact your processor's support (Teya, Straumur, Rapyd/Valitor) and ask for your online-payment / SecurePay credentials. You can also email support@soley.travel and we'll help.

Still stuck? Email support@soley.travel and we'll walk you through it.