Before integrating with the Onerway Issuing API, merchants need to complete merchant activation, environment configuration, and API credential preparation. Complete integration testing and business validation in the sandbox environment first, then switch to production after the flow is stable.
| Preparation item | Description |
|---|---|
| Merchant information | Obtain the merchant ID, API credentials, and keys used for request signing or signature verification. |
| Request source IP | Provide the fixed outbound IP used to call the API so it can be added to the API access allowlist. |
| Event receiving URL | Configure the callback URL used to receive card operation, transaction, and other event notifications. |
| Business parameters | Confirm available card products, settlement currency, card network, cardholder information requirements, and card usage rules. |
Onerway provides sandbox and production environments. The API paths are the same in both environments; only the request domain is different.
| Environment | Endpoint | Use case |
|---|---|---|
| Sandbox | https://sandbox-issuer.onerway.com/api/v1/merchant | API development, integration testing, and flow validation |
| Production | https://issuer.onerway.com/api/v1/merchant | Live business transactions and production operations |
| Step | Action | Description |
|---|---|---|
| 1 | Complete merchant and environment configuration | Obtain the merchant ID and API credentials, and configure the IP allowlist and event receiving URL. |
| 2 | Get card products | Select an available card product based on the business scenario, and confirm the card network, currency, applicable rules, and related information. |
| 3 | Create a cardholder | Submit the basic cardholder information and obtain cardholderId after creation. |
| 4 | Create a card | Use the card product and cardholder information to create a card, and configure the initial amount or related rules according to product requirements. |
| 5 | Query card information | Query card basic information, status, balance, and required sensitive information. |
| 6 | Process transactions and events | Query transaction records and receive card operation, transaction, and other event notifications. |