1. 资金划转
Lampay
  • 接入指南
  • 解密指南
  • 卡交易
    • 交易查询
      • Page Transactions
      • List Transactions
      • Get Transaction Detail
    • 交易字典
      • List Transaction Types
      • List Transaction Statuses
      • List Merchant Countries
      • List Fund Flow Types
  • 卡管理
    • 卡片查询
      • List Cards
      • Get Card
      • Reveal Sensitive Card
    • 开卡
      • Precheck Create Card
      • Create Card
      • Page Card Batch Items
      • Get Card Batch
    • 卡片设置
      • Update Card Spending Control
      • Update Card Remark
    • 卡片状态
      • Freeze Card
      • Unfreeze Card
      • Cancel Card
  • 参考数据
    • 商户数据
      • List Reference Merchants
      • Get Reference Merchant
    • 国家地区
      • Get Slash Countries
    • 消费控制
      • Get Slash Spending Restrictions
      • Get Slash Spending Presets
  • 卡产品
    • 产品组
      • Page Groups
      • List Groups
    • 产品查询
      • Page Products
      • List Products
      • Get Product Detail
    • 配置模型
      • Get Provider Product Config Schema
      • Get Provider Card Settings Schema
  • 钱包
    • 钱包查询
      • Page Wallets
      • List Wallets
      • Get Wallet
    • 账本
      • List Ledger
      • Page Ledger
      • Get Ledger
    • 资金划转
      • Transfer Out
        POST
      • Transfer In
        POST
    • 转账订单
      • List Transfers
      • Get Transfer
      • Page Transfers
      • Cancel
    • 转账字典
      • List Order Statuses
      • List Directions
      • List Approval Statuses
  1. 资金划转

Transfer Out

POST
/api/v1/consumer/card-products/wallets/transfer-out
Creates an idempotent, pending-approval order to move funds from a card wallet into the workspace's internal wallet. Funds move only after tenant approval.

Gateway Contract#

Chain: API
Portal: CONSUMER
JWT token enabled: false
Workspace kind: LIVE
Workspace portal: CONSUMER
Workspace permission: card:wallet:write
Rate limit: 120 / 60s
Rate limit strategy: IP

Common Errors#

CodeWhen
CARD_WALLET.INVALID_TRANSFER_AMOUNTamount is not greater than 0
RESOURCE.NOT_FOUNDcard wallet not found, or its card BIN group does not belong to this workspace
CARD_WALLET.INSUFFICIENT_BALANCEcard wallet balance is insufficient to debit
CARD_WALLET.INTERNAL_WALLET_NOT_FOUNDno internal wallet exists for this workspace and the wallet's currency

请求参数

Authorization
在 header 添加参数
X-Api-Key
示例:
X-Api-Key: ********************
Header 参数

Body 参数application/json必填

示例

返回响应

🟢201成功
*/*
Created
Body*/*

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.lampay.app/api/v1/consumer/card-products/wallets/transfer-out' \
--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
上一页
Get Ledger
下一页
Transfer In
Built with