1. 04 Card
YUNMO-API
  • API
    • 01 Preparations
      • 1.1 Protocol Specification
      • 1.2 Appendix
      • 1.3 Login authorization
    • 02 Customer
      • 2.1 Create Customer
      • 2.2 Query customer information
    • 03 KYC
      • 3.1 Submit KYC Information
      • 3.2 Get Liveness H5 Link
      • 3.3 Query Liveness Results
      • 3.4 Querying KYC Status
    • 04 Card
      • 4.01 Query available card samples
        POST
      • 4.02 Create virtual card
        POST
      • 4.03 Query customer card
        POST
      • 4.04 Customer card balance adjustment
        POST
      • 4.05 Customer card top-up order query
        POST
      • 4.06 Query customer card detail
        POST
      • 4.07 Destroy card
        POST
      • 4.08 Freeze card
        POST
      • 4.09 Unfreeze card
        POST
      • 4.10 Query card PAN-HTML
        POST
      • 4.11 Query card PAN
        POST
      • 4.12 Query card PIN
        POST
      • 4.13 Update phone number
        POST
      • 4.14 Update email
        POST
      • 4.15 Update card limit
        POST
      • 4.16 Bind physical card
        POST
      • 4.17 Activate physical card
        POST
    • 05 Transaction
      • 5.1 3DS Authorization Confirmation
    • 06 Webhook
      • 6.1 Notification Specification
      • 6.2 KYC callback
      • 6.3 3DS Notification
      • 6.4 Transaction Notification
    • Schemas
      • GetTokenVo
      • ApiResponse«GetTokenVo»
      • ApiRequest«GetTokenDto»
      • ApiRequest«CreateCardDto»
      • ApiRequest«CardRechargeDto»
      • ApiRequest«RechargeOrderQueryDto»
      • ApiRequest«CardDetailDto»
      • ApiRequest«CardStatusUpdateDto»
      • ApiRequest«CardPanHtmlDto»
      • ApiRequest«CardPanEncryptDto»
      • ApiRequest«CardQueryPinDto»
      • ApiRequest«CardPhoneDto»
      • ApiRequest«CardEmailDto»
      • ApiRequest«CardTradeLimitDto»
      • ApiRequest«BindCardDto»
      • ApiRequest«ActiveCardDto»
      • ApiRequest«CustomerAddDto»
      • ApiRequest«CustomerQueryDto»
      • ApiRequest«GetLivenessUrlDto»
      • ApiRequest«GetLivenessResultDto»
      • ApiRequest«KycDto»
      • ApiRequest«Confirm3DSDto»
      • CardSampleInfoVo
      • ApiRequest«Object»
      • ApiRequest«CardQueryDto»
      • ApiRequest«SubmitKycDto»
      • CreateCardDto
      • GetTokenDto
      • CardBenefitVo
      • ApiResponse«List«CardSampleInfoVo»»
      • CreateCardVo
      • ApiResponse«CreateCardVo»
      • CardQueryVo
      • ApiResponse«List«CardQueryVo»»
      • CardQueryDto
      • CardRechargeVo
      • ApiResponse«CardRechargeVo»
      • CardRechargeDto
      • RechargeOrderQueryVo
      • ApiResponse«RechargeOrderQueryVo»
      • RechargeOrderQueryDto
      • CardDetailVo
      • ApiResponse«CardDetailVo»
      • CardDetailDto
      • ApiResponse«Boolean»
      • CardStatusUpdateDto
      • ApiResponse«String»
      • CardPanHtmlDto
      • ApiEncryptVo
      • ApiResponse«ApiEncryptVo»
      • CardPanEncryptDto
      • CardQueryPinDto
      • CardPhoneDto
      • CardEmailDto
      • CardTradeLimitDto
      • BindCardVo
      • ApiResponse«BindCardVo»
      • BindCardDto
      • ActiveCardDto
      • CustomerAddVo
      • ApiResponse«CustomerAddVo»
      • CustomerAddDto
      • CustomerQueryVo
      • ApiResponse«CustomerQueryVo»
      • CustomerQueryDto
      • LivenessUrlQueryDto
      • ApiResponse«LivenessUrlQueryDto»
      • GetLivenessUrlDto
      • LivenessResultQueryDto
      • ApiResponse«LivenessResultQueryDto»
      • GetLivenessResultDto
      • SubmitKycDto
      • InHouseKycInfoVo
      • ApiResponse«InHouseKycInfoVo»
      • KycDto
      • Confirm3DSDto
  1. 04 Card

4.04 Customer card balance adjustment

Sandbox Env
https://sandbox-api.yunmo.io
Sandbox Env
https://sandbox-api.yunmo.io
POST
/api/v1/card/rechargeCard
1.
Adjust the balance of the customer's card
2.
Note that when the balance of the customer card is increased, it may not be received immediately (some card samples are received asynchronously). You need to use the orderNo returned by this interface to call the 4.05 interface to query whether the balance is successful.

Request

Body Params application/json

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox-api.yunmo.io/api/v1/card/rechargeCard' \
--header 'Content-Type: application/json' \
--data '{
    "nonce": "stringstringstri",
    "sign": "stringstringstringstringstringst",
    "merchantNo": "string",
    "token": "string",
    "requestTime": 0,
    "version": "string",
    "data": {
        "cardId": "string",
        "tradAmount": 0
    }
}'

Responses

🟢200
application/json
Bodyapplication/json

Example
{
    "code": "string",
    "msg": "string",
    "timestamp": 0,
    "data": {
        "orderNo": "string",
        "status": 0,
        "beforeBalance": 0,
        "afterBalance": 0
    }
}
Modified at 2026-02-12 06:44:00
Previous
4.03 Query customer card
Next
4.05 Customer card top-up order query
Built with