Onerway Merchant API Testing

API Version: v1.0.0

Overview

The Onerway Merchant API Testing Platform provides a comprehensive environment for integrating with our payment processing system. This platform enables you to:

Test API functionality without development resources

Receive real-time request and response data

Simulate various business scenarios

Access detailed parameter specifications and examples

Ideal for:

Prospective merchants evaluating Onerway services

Technical teams implementing system integration

Existing merchants troubleshooting API issues

Getting Started

Step 1: Obtain Authentication Credentials

Before using the platform, retrieve the following from your merchant dashboard:

merchantNo: Your unique merchant identifier

appId: Application identifier for your site

secretKey: Used for signature generation (secure storage required)

Note: Contact your account manager if you haven't received these credentials

Step 2: Select Environment

Environment	Description	Use Case
Sandbox	Simulated transactions with no actual funds movement	Development and testing
Production	Live transactions involving actual funds	Production operations

Important: Complete comprehensive testing in the sandbox environment before migrating to production

Step 3: Initialize Environment Variables

MERCHANT-NO: Merchant identifier

secret: Signature key

APPID: Application identifier

WEBHOOK-ENDPOINT: Payment callback URL

RETURN-URL: Frontend redirect URL after payment completion

Step 4: Select API Endpoints

Our comprehensive payment processing solution covers the complete transaction lifecycle:

Core Payment Functions

Checkout 🔵: Standardized payment experience with rapid integration

JS-SDK 🔵: Server-side order creation for custom payment interfaces

API Core 🔵: Low-level payment processing with maximum flexibility

APMs 🔵: Support for global payment methods including wallets and bank transfers

Integration	Use Case	Complexity	Customization	Maintenance
`Checkout`	Rapid deployment, standard flows	Low	Basic	Low
`JS-SDK`	Custom payment UI	Medium	High UI control	Medium
`API`	Fully custom payment flows	High	Complete control	High
`APMs`	Global market expansion	Medium	Varies by method	Medium

Post-Transaction Processing

Refund 🔵: Complete refund lifecycle management

Settlement 🔵: Merchant fund settlement with reconciliation file access

Query and Management

Query 🔵: Comprehensive data retrieval for transactions, installments, subscriptions, chargebacks, and tokenized cards

Utils 🔵: Auxiliary functions including signature verification

🔵 Stable | 🟡 Beta | 🟠 Deprecated

Step 5: Initiate Test Requests

Select the desired API endpoint from the navigation panel

Complete the required request parameters (pre-populated with sample values)

Click "Send" to submit the request

Review the response and detailed information

WARNING

If you encounter Repeated order transactions!, click the auto-generate button

Core Payment Flow

Common Error Handling

Error Code	Description	Resolution
`13027`	Repeated order transactions!	Click `auto-generate` to refresh request parameters
`40013`	Abnormal parameters (cannot be read)	Please check environment vairables
`70002`	Unknown decline	Contact technical support

Tip: For a complete list of error codes, refer to the Error Code Documentation

Security Best Practices

API Key Protection

Never store keys in client-side code

Signature Verification

Include valid signatures with all requests

Verify signatures on all webhook notifications

Use HTTPS for all API communications

IP Whitelisting

Configure API call IP whitelists in the merchant dashboard

Restrict webhook receiver server IP ranges

Terminology

Term	Definition
Merchant	Entity using Onerway payment services
Transaction	Single payment event
Settlement	Funds settlement process
Chargeback	Transaction dispute initiated by consumer
Webhook	Asynchronous notification mechanism
Tokenization	Card information encryption technology

Technical Support

For technical assistance:

Support Email: abel.wang@onerway.com

Issue Reporting Process:

Prepare order number, error details, and reproduction steps

Submit detailed issue description with screenshots

Technical team will respond within one business day

Overview#

Getting Started#

Step 1: Obtain Authentication Credentials#

Step 2: Select Environment#

Step 3: Initialize Environment Variables#

Step 4: Select API Endpoints#

Core Payment Functions#

Post-Transaction Processing#

Query and Management#

Step 5: Initiate Test Requests#

Core Payment Flow#

Common Error Handling#

Security Best Practices#

Terminology#

Technical Support#

Overview

Getting Started

Step 1: Obtain Authentication Credentials

Step 2: Select Environment

Step 3: Initialize Environment Variables

Step 4: Select API Endpoints

Core Payment Functions

Post-Transaction Processing

Query and Management

Step 5: Initiate Test Requests

Core Payment Flow

Common Error Handling

Security Best Practices

Terminology

Technical Support