2.1.52 Recharge Query

Path:/openapi/card/recharge/query

Method:POST

Content-Type:application/json

Response Content-Type:application/json

Description:

Example Request:

{
  "card_id": "00003454323400000028888",
  "mc_trade_no": "48d2741747a4493223feb22"
}

Request Parameter:

Parameter Name Type Required Description
card_id string true Card ID
mc_trade_no string true Merchant transaction business no,Define by merchant;Maximum 128 characters; equals to 2.1.4 recharge mc_trade_no

API Response:

Parameter Name Type Description
code string Error code
data object Data object for this respond
  card_coin string Recharged fiat currency
  coin_exchange_usd_rate string Exchange rate;Exchange rate from payment coin to USD. Payment coin/USD
  currency_amount string Fiat amounts received
  currency_exchange_usd_rate string Fiat exchange rate;Exchange rate from card coin to USD. Card Coin/USD
  order_no string Order transaction no, generated by HyperCard, Maximum 64 characters
  pay_coin string Payment coin use for recharge
  real_recharge_amount string Recharge amount in payment coin. This is the amount after deducted all the fee.
  recharge_amount string Recharge amount in payment coin. Must be large than 0.
  recharge_fee_amount string Recharge fee in payment coin
  recharge_fee_usdt_amount string Recharge exchange fee in payment coin. Fee to exchange from payment coin into USDT.
  card_id string Card ID
  mc_trade_no string Merchant transaction business no
  status integer Recharge status 324_recharge_status
  fail_reason string Fail reason, only status = 2 this field will have value
msg string Error message

Example Response:

{
    "code": "00000",
    "msg": "ok",
    "data": {
        "order_no": "20250719104417971096",
        "recharge_amount": "102.71614508",
        "pay_coin": "usdt",
        "recharge_fee_amount": "2.59209940",
        "recharge_fee_usdt_amount": "0.00000000",
        "real_recharge_amount": "100.12404568",
        "currency_amount": "100.00000000",
        "card_coin": "usd",
        "coin_exchange_usd_rate": "0.99876108",
        "currency_exchange_usd_rate": "1.00000000",
        "card_id": "00003454323400000028888",
        "mc_trade_no": "48d2741747a4493223feb22",
        "status": 0,
        "fail_reason": ""
    }
}
Copyright © HyperCard 2023 all right reserved,powered by GitbookUpdate Time: 2025-07-28 17:22:52

results matching ""

    No results matching ""