Get Started

Complete guide from registration to your first payment

Prerequisites

Register and Complete KYC

ONERWAY uses a unified account system. If you are a new merchant, please complete account registration and KYC verification first:

  1. Visit the ONERWAY Merchant Registration Page to register
  2. Log in to the merchant portal and start the onboarding process
  3. Submit KYC materials to complete identity verification

For detailed process and material requirements, refer to Create an Account.

Apply for Transfer Business (KYB)

After KYC approval, you need to complete the KYB (business review) process for the Transfer product:

  1. In the merchant portal, go to the Transfer menu and apply to enable Transfer business
  2. Submit additional materials related to Transfer business as required
  3. ONERWAY conducts business review
  4. After approval, sign the Transfer business contract
  5. Transfer functionality is officially enabled after contract signing
Transfer functionality is only available after KYB review and contract signing are complete. If you have questions during the review process, please contact your account manager.

Account Funding

Fund your account before initiating payouts.

  1. Go to Balance accounts > Funding account balance and click Deposit.
  2. Select the deposit currency and transfer funds to the bank account shown. Include the Payment reference in the transfer remarks.
  3. After completing the transfer, enter the payer name, deposit amount, and deposit date. You may also upload proof of transfer, then submit the deposit application.
  4. Onerway will review the incoming payment after receiving the funds. Review is expected to take 1–2 business days. Once approved, the funds will be credited to the corresponding currency balance.

You can check the application status under Balance details > Deposits for the corresponding currency.

Make sure the payer name matches the bank account holder’s name and that the transfer amount, date, and payment reference are entered correctly to avoid processing delays.

Start Making Payments

Portal Operations

No coding required—complete payments directly in ONERWAY Portal.

Add Beneficiary

  1. Go to the "Beneficiaries" page and click "Add Beneficiary"
  2. Select destination country/region, currency, and entity type (Individual/Business)
  3. Complete beneficiary information as prompted and save
After saving, account location, currency, and entity type cannot be edited. To modify, delete and re-add the beneficiary.

Initiate Payment

  • Beneficiaries page: Select the target beneficiary and initiate payment directly
  • Payments page: Click "Make Payment", create or select a beneficiary, then initiate

Enter payment amount and related information, complete security verification (payment password or email verification code), and submit.

View Payment Results

Check progress on the "Payments" page. Download payment receipt upon success; modify and retry based on the reason if failed.

API Integration

Full control over your payment flow via API, ideal for high-frequency transactions and automation.

Documentation and Merchant Registration

Key URLs:

Registration requirements: Fill in email, verification code, and password (corporate email recommended; keep account information secure). Identity verification is required after registration.

Merchant Review and Activation

Merchants need to prepare the following materials for API whitelist configuration:

MaterialDescription
Callback URLFor receiving Webhook notifications of payment status changes
Egress IPFor API request whitelist
Auth TokenFor callback notification authentication

Review timeline: Completed within 1 business day.

Get Merchant Information

After approval:

  1. Log in to the merchant portal; password reset required on first login
  2. Obtain "Merchant ID + Secret Key" from the portal for subsequent API request signing
  3. Complete integration testing in the sandbox environment
  4. Switch to production after testing (only change request domain and configuration parameters)

Environment URLs:

EnvironmentDomainPurpose
Sandboxhttps://sandbox-api.onerway.com/payoutSimulate payment flow, no real transactions
Productionhttps://api.onerway.com/payoutLive transactions
Sandbox Portalsandbox-merchant.onerway.comSandbox merchant portal
Production Portalmerchant.onerway.comProduction merchant portal
Only whitelisted domains/IPs can call ONERWAY APIs. Keep your merchant ID and secret key secure to prevent leakage.

Add Beneficiary

Initiate Payment

Initiate Payment by Beneficiary IDTransfer API — Use the created beneficiaryId

View Payment Results

Overview

Send funds globally with speed, low cost, and security through ONERWAY Transfer.

Bank Transfer

ONERWAY supports sending funds to global bank accounts via SWIFT international wire and local transfer