Go live: from sandbox to production

Prerequisites

This guide puts the launch steps in order: get the right credentials, open your sandbox account, test what you built, then switch to production with the checklist below. Each step links to the reference page with the details.

Step 1: Know which credentials you need

Which credential is which, who has it, where each one goes and where to find it in the dashboard: The credentials at a glance and Getting credentials. Only the public key may appear in browser or mobile code.

Step 2: Open your sandbox account

Open your test account and find its keys as described on Getting credentials.

Step 3: Build and test in the sandbox

Send every sandbox call to https://sandbox.payme.io/api/ with your sandbox credentials. Before you go live, run every check in the Quickstart with your own code: create a sale, pay it, receive the callback, confirm the sale with get-sales, try a decline card and refund the sale. The callback URL must be a public address even in the sandbox: see Callback URL rules.

If your sales go through 3D Secure, test the challenge too: the cards and the rules that select a sale are on 3D Secure in the sandbox.

All test data, including the other decline cards, Apple Pay cards and bank accounts, is on Test Cards and Payment Methods.

What the sandbox doesn't cover

Step 4: Go-live checklist

Work through every item before your first live sale.

Credentials and URLs

A credential from the other environment fails: a sandbox MPL in production returns 251, and a partner key from the other environment returns 200. See Errors.

Browser code

Test data

Payment methods and services

Amounts and commercials

Callbacks

Details: Callbacks.

Retries, limits and monitoring

First live payment

Run one real sale for a small amount with your own card, and refund it. Check that the callback arrived and that get-sales shows the sale. If PayMe issues invoices for your sales, check the document on this sale too.

If a key leaks

See If a key leaks.

After launch

Partners

If you are a platform or marketplace:

The whole partner flow is on Start here: build a platform or marketplace on PayMe.