卡钱包转入

POST

/card-products/wallets/transfer-in

向卡钱包转入资金。钱包 ID 可从卡钱包列表获取。

本接口要求幂等键，重试同一业务操作时复用原值。

常见错误

错误码	触发条件
`CARD_WALLET.INVALID_TRANSFER_AMOUNT`	金额必须大于 0。
`RESOURCE.NOT_FOUND`	卡钱包不存在或不在当前访问范围内。
`CARD_WALLET.INTERNAL_WALLET_NOT_FOUND`	未找到对应币种的内部钱包。
`CARD_WALLET.INTERNAL_WALLET_INSUFFICIENT_BALANCE`	内部钱包可用余额不足。
`REQUEST.CONFLICT`	同一幂等请求仍在处理中，或幂等键已用于不同请求。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "cardWalletBizId": "UCPGW_ABCDEF1234567890",
    "amount": 10000
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/card-products/wallets/transfer-in' \
--header 'X-API-VERSION: 1' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm;' \
--header 'X-Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "cardWalletBizId": "UCPGW_ABCDEF1234567890",
    "amount": 10000
}'

返回响应

🟢201成功

*/*

Created

Headers

Body*/*

示例

{
    "version": "string",
    "timestamp": 0,
    "success": true,
    "code": "string",
    "message": "string",
    "data": {
        "bizId": "cbgwo_1234567890abcdef",
        "userCardProductGroupWalletBizId": "cbgw_1234567890abcdef",
        "internalWalletBizId": "iw_1234567890abcdef",
        "direction": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "currency": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active",
            "scale": 2,
            "isFiat": true,
            "isStablecoin": false
        },
        "amount": 10000,
        "amountScale": 2,
        "status": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "approvalStatus": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "requestedBy": "user_1234567890abcdef",
        "approvedBy": "user_abcdef1234567890",
        "approvedAt": 1767225600000,
        "rejectionReason": "Insufficient approval evidence",
        "completedAt": 1767225660000,
        "failureReason": "Provider transfer failed",
        "createdAt": 1767225500000,
        "updatedAt": 1767225600000
    }
}

修改于 2026-09-21 10:39:41

卡钱包转出

交易订单状态字典