Getting Started with 1Money

Get started with 1Money

Welcome to 1Money. This guide walks you through the fastest path to a successful integration—from getting sandbox access to going live in production.

1) Create your account and get access

Sign up for a 1Money developer account and create a workspace for your team. From there, you’ll be able to generate API credentials, configure webhooks, and manage environments.

2) Choose an environment: Sandbox vs Production

1Money provides two environments:

Sandbox: A safe, test-only environment that mirrors production behavior. Use it to build and validate your integration end-to-end without moving real funds.
Production: The live environment for real transactions and real customer activity.

Start in Sandbox and move to Production once you’ve completed testing and operational readiness checks.

3) Generate API keys

Create API keys for each environment and store them securely. We recommend:

Using separate keys for each application or service
Rotating keys regularly
Never embedding keys in client-side code

4) Set your base URLs and authentication

Point your integration to the correct environment base URL and include your API credentials on every request. All requests must be made over HTTPS.

5) Configure webhooks for real-time updates

Webhooks keep your system in sync with 1Money events (e.g., deposit updates, conversion completion, withdrawal status changes). To get started:

Add your webhook endpoint URL(s) in the Developer Dashboard
Choose the event types you want to receive
Verify webhook signatures to confirm authenticity
Return a 2xx response quickly, then process asynchronously (recommended)

Webhooks are the primary way to track transaction lifecycle changes—don’t rely on polling except for reconciliation or backfills.

6) Test the full flow in Sandbox

Before going live, we recommend you validate:

Authentication + permission scope
Creating and retrieving resources
Idempotency behavior (safe retries)
Webhook delivery and signature verification
Status transitions (pending → completed/failed)
Error handling and rate limits

7) Go live in Production

When you’re ready to launch:

Switch to Production keys and Production base URL
Recreate your webhook endpoints in Production
Confirm monitoring and alerting are in place
Run a small set of live test transactions before scaling up