SpicePay

Quickstart

From onboarding to your first test payment.

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: snd_****************" \
  -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"
}

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 a test card (e.g. 4242 4242 4242 4242, a Stripe test card, on a Stripe test-mode connector), and watch the transaction appear under Transactions in the Control Center.

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.