Card Operations API

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

Create Card

Create a card for a specified cardholder with a designated card product and initial deposit amount.

Item	Details
Endpoint	`POST /api/v1/merchant/card/createCard`

Field	Type	Required	Description
`merchantNo`	Long	✅	Merchant number
`clientRequestId`	String(64)	✅	Idempotent request ID, must be unique per operation
`cardholderId`	Long	✅	Cardholder ID
`productId`	Long	✅	Card product ID
`amount`	BigDecimal	✅	Initial deposit amount, must be greater than 0

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "cardId": 100001
  }
}

Perform status operations on a card, such as freeze or unfreeze.

Item	Details
Endpoint	`POST /api/v1/merchant/card/operate`

Field	Type	Required	Description
`merchantNo`	Long	✅	Merchant number
`clientRequestId`	String(64)	✅	Idempotent request ID
`cardId`	Long	✅	Card ID
`type`	String(20)	✅	Operation type: `FREEZE` / `UNFREEZE`

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "operateRecordId": 200001
  }
}

Deposit a specified amount to a card.

Item	Details
Endpoint	`POST /api/v1/merchant/card/deposit`

Field	Type	Required	Description
`merchantNo`	Long	✅	Merchant number
`clientRequestId`	String(64)	✅	Idempotent request ID
`cardId`	Long	✅	Card ID
`amount`	BigDecimal	✅	Deposit amount, must be greater than 0

{
  "respCode": "20000",
  "respMsg": "success",
  "data": {
    "operateRecordId": 200002
  }
}

Issuing API

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

Card Query API

Card query APIs including operation records, basic info, balance, and sensitive information.