Skip to main content

​
Quickstart Guide

Get up and running with SpacePay in just a few minutes. This guide will walk you through the essential steps to start accepting cryptocurrency payments.

​
Prerequisites

Before you begin, make sure you have:
  • A business email address
  • Business registration documents (for verification)
  • A website or application where you want to accept payments
  • Basic understanding of APIs (for technical integration)

​
Step 1: Create Your Account

1

Sign Up

Visit the SpacePay Dashboard and click “Sign Up” to create your account.
You can sign up using your Google account for faster registration, or use your business email address.
2

Complete Business Information

Fill in your business details including:
  • Company Name: Your registered business name
  • Industry: Select your business industry category
  • Country: Your business location
  • Business Email: Use your business email address
  • Phone Number: Business contact number
  • Website: Your company website URL

​
Step 2: Business Verification

Business verification is required before you can accept live payments. Our support team will contact you to complete this process.
1

Wait for Support Contact

Once you’ve completed your account registration, our support team will contact you to gather additional KYC (Know Your Customer) and KYB (Know Your Business) information.
2

Provide Required Information

Our support team will guide you through providing: - Business registration documents - Identity verification for authorized signatories - Additional compliance information - Business activity details
3

Verification Review

Our compliance team will review your information and complete the verification process.
You’ll receive email updates about your verification status throughout the process.

​
Step 3: Get Your API Keys

Once your account is verified, you can access your API keys:
1

Navigate to API Settings

In your dashboard, go to Settings → Developers → API Keys.
2

Generate Keys

Click “Generate New Key” to create your API credentials.
Keep your API keys secure and never share them publicly. Use environment variables in your code.
3

Setup Webhook URL

Configure your webhook endpoint to receive real-time payment notifications:
  • Enter your webhook URL (must be HTTPS)
  • Test your webhook endpoint to ensure it’s working correctly

​
Step 4: Accept Your First Payment

Now you’re ready to integrate SpacePay into your application:
For more control, integrate directly with our API:
// Create a payment
const response = await fetch('https://api.spacepay.co.uk/v1/external/secretkey-auth/payments', {
  method: 'POST',
  headers: {
    'X-SpacePay-Secret-Key': 'sk_test_your_secret_key',
    'Content-Type': 'application/json',
    'Idempotency-Key': 'unique-key-for-request' // Optional but recommended
  },
  body: JSON.stringify({
    orderId: 'order_123',
    amount: 100, // $1.00 in cents (minimum: 100, maximum: 100000000)
    currency: 'USD',
    redirectUrl: 'https://merchant.example.com/checkout/success', // Optional
    customMetadata: '{"cartId":"abc123","promo":"SUMMER24"}' // Optional
  })
});

const payment = await response.json();
// Access payment.paymentUrl to redirect customer to payment page
Embed our payment widget directly in your page:
<div id="spacepay-checkout"></div>
<script src="https://js.spacepay.co.uk/v1/checkout.js"></script>
<script>
  SpacePayCheckout.mount('#spacepay-checkout', {
    apiKey: 'your-api-key',
    amount: 10000,
    currency: 'USD'
  });
</script>

​
Step 5: Test Your Integration

Before going live, test your integration thoroughly:
1

Use Test Mode

Make sure you’re using test API keys and test mode in your integration.
2

Test Different Scenarios

Test various payment amounts, currencies, and failure scenarios.
3

Verify Webhooks

Set up webhook endpoints to receive payment notifications and test them.
4

Check Dashboard

Verify that payments appear correctly in your SpacePay dashboard.

​
Going Live

When you’re ready to accept real payments:
1

Switch to Live Mode

Update your integration to use live API keys and live endpoints.
2

Monitor Transactions

Keep an eye on your dashboard for the first few transactions to ensure everything works smoothly.

​
What’s Next?

Congratulations! You’re now ready to accept cryptocurrency payments. Here are some next steps:

Explore Advanced Features

Learn about refunds, partial payments, and advanced payment flows.

Set Up Reporting

Configure reporting and analytics for your payment data.

Integrate Webhooks

Set up real-time payment notifications for your application.

Get Support

Access our support resources and contact information.
Need help? Our support team is available 24/7. Check out our Support section for contact information and resources.