充值预检

POST

/card-products/10010107/prepaid/cards/recharge/precheck

检查充值条件及费用。使用平台保存的余额快照，不代表渠道实时余额；不会划转资金、冻结费用或预占余额。

常见错误

错误码	触发条件
`RESOURCE.NOT_FOUND`	当前工作区内找不到该卡片或钱包。
`VALIDATION.INVALID_PARAMETER`	金额或预付卡渠道不符合要求。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "cardInfoBizId": "CI_ABCDEF1234567890",
    "amount": 2500
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.lampays.com/card-products/10010107/prepaid/cards/recharge/precheck' \
--header 'X-API-VERSION: 2' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "cardInfoBizId": "CI_ABCDEF1234567890",
    "amount": 2500
}'

返回响应

🟢200成功

application/json

请求成功。

Bodyapplication/json

示例

{
    "version": "string",
    "timestamp": 0,
    "success": true,
    "code": "string",
    "message": "string",
    "data": {
        "allowed": true,
        "amount": 2500,
        "feeItems": [
            {
                "feeType": {
                    "code": "ACTIVE",
                    "value": 35010102,
                    "label": "Active"
                },
                "amount": 25
            }
        ],
        "walletBalance": 10000,
        "totalDebit": 2525,
        "grossCredit": 2500,
        "netCredit": 2475,
        "balanceAfter": 7475,
        "cardBalance": 8000,
        "snapshotOnly": true,
        "failureReason": "Insufficient wallet balance"
    }
}

修改于 2026-09-19 14:18:07

时区字典

充值