SDK Integration Guide

Onerway SDK provides a secure, optimized payment experience with various integration options.

Introduction

The SDK integration is an embedded payment solution that allows merchants to integrate payment functionality directly into their applications or websites:

• Integration Point: Directly embedded into the merchant's website or application
• Control Method: The merchant controls the UI/UX of the payment flow, while Onerway handles the payment processing

This SDK solution offers:

1. Customizable payment interface
2. Support for multiple payment methods
3. Secure payment environment
4. Processing of sensitive payment data
5. PCI DSS compliance
6. Optimized payment experience

Note

The SDK payment component is powered by Onerway core functionality, allowing merchants to customize the interface according to their needs while reducing compliance burden and security responsibilities.

Integration Flow

The SDK integration flow is as follows:

1. Client obtains customer order information
2. Client sends order information to server
3. Server requests Onerway transaction API to obtain transactionId and redirectUrl
4. Server sends transactionId and redirectUrl to client
5. Client loads Onerway JavaScript library
6. Client initializes the SDK to render the payment component using transactionId and redirectUrl
7. Customer completes payment in the SDK payment interface
8. Server receives webhook notification, updates payment result, and responds with the transactionId

Flow Diagram

⚠️ Important: After processing the webhook notification, you must return the transactionId received in the notification payload.

Integration Best Practices

1. Security Verification: Always verify notifications from Onerway to ensure authenticity
2. Asynchronous Processing: Implement proper webhook handling logic to ensure transaction status is accurately updated
3. Error Handling: Implement appropriate error handling and fallback mechanisms in your SDK integration
4. Responsive Design: Ensure the SDK payment interface displays properly on various devices
5. Testing: Thoroughly test the payment flow before deploying to production