Issuing API

Onerway Issuing Merchant API documentation covering card management, cardholder management, transaction queries, and event webhooks.

The Onerway Issuing API enables merchants to create and manage cards, manage cardholders, query transactions, and receive real-time webhook notifications for card operations and transaction events.

API Version: v1.0 | Base Path: /api/v1/merchant | Method: POST

API Overview

Card Operations API
Create cards, freeze/unfreeze, and deposit operations
Card Query API
Query operation records, basic info, balance, and sensitive information
Cardholder API
Create, update, and query cardholder information
Common & Transaction API
Region/city lists, mobile area codes, and transaction record queries
Webhooks
Card operation and transaction event webhook notifications with signature verification

Common Specifications

Request Headers

HeaderTypeRequiredDescription
Content-TypeStringYesapplication/json;charset=UTF-8
X-ONERWAY-APIKEYStringYesMerchant identity key

Response Structure

FieldTypeDescription
respCodeStringResponse code, 20000 indicates success
respMsgStringResponse message
dataObject/ArrayBusiness data, null on failure

Error Codes

CodeDescription
20000Success

Overview

Overview of Onerway Issuing

Card Operations API

Card operation APIs including card creation, freeze/unfreeze, and deposit.