Live environment
Straumur runs two environments. Test (also called staging) is where you build and verify your integration; nothing you do there moves money. Live is production. They are separate systems with separate credentials: nothing created in one exists in the other.
Hostnames
Every endpoint page in this documentation shows the test URL. On live, only the hostname changes; paths, headers, request and response bodies are identical.
| Test | Live | |
|---|---|---|
| Checkout API (all endpoints in these docs) | https://checkout-api.staging.straumur.is/api/v1/… | https://greidslugatt.straumur.is/api/v1/… |
| Hosted payment page (where shoppers are redirected) | https://hosted-checkout.staging.straumur.is | https://greidslusida.straumur.is |
| Merchant Portal | merchant.staging.straumur.is | thjonustuvefur.straumur.is |
| Partner Portal | partner.staging.straumur.is | samstarf.straumur.is |
You never build the hosted payment page URL yourself; the url in the create-checkout response already points at the right host. The row is here for integrators who allow-list redirect targets or outbound hosts.
For Components, the environment option in the component configuration switches between "test" and "live". If you use Adyen Components, Adyen's script and stylesheet also move from checkoutshopper-test.cdn.adyen.com to checkoutshopper-live.cdn.adyen.com; see Adyen web integration.
What changes when you go live
Going live is not only a hostname swap. Each of these is issued per environment, so all of them change at once:
- API key. Create a live key in the live Merchant Portal or Partner Portal. A test key is rejected on live with
401. See API Keys. - Terminal Identifier. Every solution has its own terminal in each environment. Copy the live identifiers from the live portal; a test identifier on live fails with error
2016. - Webhooks. Register your endpoint again in the live portal and take the live HMAC key and webhook API key from there. Live events are never delivered to an endpoint registered in test. See Webhook configuration.
- Test cards do not work on live. The Payment Gateway's
requestedTestAcquirerResponseCodefield (accepted on the/paymentrequest only; checkout requests do not take it) is rejected on live with error2028. Use a real card for a small first payment, then refund it. - Apple Pay and Google Pay each need their own approval before live: Apple Pay, Google Pay.
- Tokens are environment-specific too. Cards saved in test cannot be charged on live.
Store the hostname, API key, terminal identifiers and HMAC key as one configuration set per environment, and switch the set rather than individual values. Most "works in test, fails in production" tickets are one value left pointing at test.
Live credentials come with your Straumur agreement. Log in to the live portal to create keys and find your terminals, then work through the go-live checklist.