Quickstart

This guide takes you from a freshly provisioned account to a completed test payment.

1. Get onboarded

SpicePay accounts are set up by our team, not self-service — contact sales and tell us about your business, volume, and markets. Onboarding covers compliance checks, your processor lineup, and account provisioning; you'll receive an invitation email to set your password on dashboard.spicepay.net.

Once you're in, enable two-factor authentication under Profile → Security before anything else — strongly recommended.

2. Create a project and shop

SpicePay organizes your business as projects (an environment or product line) containing shops (a storefront with its own checkout configuration).

1. Go to Projects → New project, name it, and pick your home region.
2. Inside the project, create a shop. The shop holds your checkout branding, supported payment methods, and webhook endpoints.

3. Connect a processor

1. Open Connectors and choose your processor (e.g. Stripe or NowPayments).
2. Enter the API credentials from your processor dashboard — use test keys first.
3. Enable the payment methods you want this connector to serve.

The connector shows up as Connected and immediately starts serving its payment methods at checkout.

4. Take a test payment

The fastest path is a payment link on Hosted Checkout:

curl https://api.spicepay.net/payments \
  -H "api-key: prd_****************" \
  -H "Content-Type: application/json" \
  -d @body.json

{
  "amount": 1999,
  "currency": "EUR",
  "payment_link": true,
  "description": "Test order #1",
  "return_url": "https://example.com/thanks",
  "test_mode": true
}

test_mode: true runs this against your processor's sandbox and keeps it out of your live transactions and analytics. Drop the field when you go live. See Environments — including what happens on a processor that has no sandbox credentials stored.

The response includes the payment_id and merchant_id. Open the hosted checkout at https://checkout.spicepay.net/pay/{merchant_id}/{payment_id}, pay with your processor's test card (4242 4242 4242 4242 on Stripe), and watch the transaction appear under Transactions in the Control Center — with a Test badge, and filtered out of the default Live view.

5. Receive webhooks

Add an endpoint under your shop's Webhooks tab and handle at least:

• payment_succeeded
• payment_failed
• refund_succeeded

See Webhooks for signature verification.

Going live

1. Swap test credentials for live credentials on your connector.
2. Re-run one real payment end to end (and refund it).
3. Review Team & roles so operations staff get scoped access instead of shared logins.