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.

Fund Your Account

After Transfer is enabled, you need to fund your account before initiating payments.

  1. In the merchant portal "Account Balance" page, view the bank account information provided by ONERWAY
  2. Transfer funds from your corporate account to that bank account offline
  3. After transfer, submit a top-up record in the merchant portal (fill in transfer amount, date, etc.)
  4. After ONERWAY review and confirmation, funds are credited and account balance is updated
Ensure the transfer reference matches the information submitted in the merchant portal for faster review completion.

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-portal.onerway.comSandbox merchant portal
Production Portalportal.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