Transfer In
POST
/api/v1/consumer/card-products/wallets/transfer-in
Gateway Contract
Common Errors
| Code | When |
|---|---|
CARD_WALLET.INVALID_TRANSFER_AMOUNT | amount is not greater than 0 |
RESOURCE.NOT_FOUND | card wallet not found, or its card BIN group does not belong to this workspace |
CARD_WALLET.INTERNAL_WALLET_NOT_FOUND | no internal wallet exists for this workspace and the wallet's currency |
CARD_WALLET.INTERNAL_WALLET_INSUFFICIENT_BALANCE | internal wallet balance is insufficient to fund the card wallet |
请求参数
Header 参数
Body 参数application/json必填
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.lampay.app/api/v1/consumer/card-products/wallets/transfer-in' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm;' \
--header 'X-Idempotency-Key;' \
--header 'X-Workspace-Id;' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"cardWalletBizId": "CW_ABCDEF1234567890",
"amount": 10000,
"idempotentKey": "string"
}'响应示例响应示例
{
"version": "string",
"timestamp": 0,
"success": true,
"code": "string",
"message": "string",
"data": {
"bizId": "cbgwo_1234567890abcdef",
"cardBinGroupWalletBizId": "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": 1767225600,
"rejectionReason": "Insufficient approval evidence",
"completedAt": 1767225660,
"failureReason": "Provider transfer failed",
"createdAt": 1767225500,
"updatedAt": 1767225600
}
}修改于 2026-07-29 05:18:57