Set up your development environment

Set up your sandbox account, retrieve API credentials, and configure base URLs to prepare your app for integrating Onerway.

Prerequisites

Before you start building with Onerway APIs, you need to:

  • Create a sandbox account for testing
  • Obtain your API credentials (merchant number, secret key, and Application ID)
  • Configure the

Initial Setup

To create a sandbox account, provide your and the where you'll integrate payments. Onerway will typically set up your testing environment within 1–2 business days.

After your sandbox account is ready, log in to the Sandbox Portal to retrieve your API credentials:

Never expose your Secret Key in client-side code or commit it to source control. Use environment variables or your platform's secret manager.

Configure the appropriate base URL for your environment:

Always use the sandbox URL during development and testing to avoid processing real transactions. Do not mix sandbox credentials with production URLs (or vice versa).
EnvironmentBase URL
Sandboxhttps://sandbox-acq.onerway.com
Productionhttps://acq.onerway.com

Example environment variable configuration:

env.yaml
ONERWAY_BASE_URL=https://sandbox-acq.onerway.com

Integration Overview

Understand the 7-step integration workflow—from kickoff meeting to production launch with Onerway support.

Send your first Onerway API request

Get started with the Onerway API by creating your first payment order.