转账功能可让您在 Currencycloud 账户的不同余额之间管理资金流动。您可以将资金从主账户转移到子账户,也可以从子账户转移回主账户。
在本集成指南中,我们将介绍如何在账户之间进行余额转账。请注意,转账过程中不进行货币兑换,因此发送和接收账户必须以相同货币持有资金。
第 1 步:登录
请参阅验证指南,获取开始新 API 会话的说明。
第 2 步:查看余额
在查看您的余额指南中,我们介绍了如何查询特定货币的账户余额,以及如何获取您账户中每种可用货币的余额。
在进行转账之前,查看可用余额非常重要。如果账户余额不足以完成转账,转账交易将保持“待处理”状态,直到有足够的资金可用。
第 3 步:指示转账
Create Transfer 端点允许您将源账户中的货币余额转移到目标账户。
POST /v2/transfers/create
| 参数名称 | 参数类型 | 示例值 |
|---|---|---|
currency |
表单数据 | EUR |
source_account_id |
表单数据 | aea097c2-39e4-49b5-aaa6-c860ca55ca0b |
destination_account_id |
表单数据 | 22ed17b5-b90c-424e-aa78-d24928b1778e |
reason |
表单数据 | funds movement |
amount |
表单数据 | 1000.00 |
X-Auth-Token |
标头 | ea6d13c7bc50feb46cf978d137bc01a2 |
{
{
"id":"883c665f-c8ee-475a-98f1-b88d73bfbf3e",
"short_reference":"BT-20190301-FFSXLC",
"source_account_id": "cf28b2d8-5afa-4d7f-9a26-7b45bf616a11",
"destination_account_id":"22ed17b5-b90c-424e-aa78-d24928b1778e",
"currency":"GBP",
"amount":"100.00",
"status": "pending",
"reason": null,
"created_at":"2019-03-01T16:44:30+00:00",
"updated_at":"2019-03-01T16:44:30+00:00",
"completed_at": null,
"creator_account_id":"72970a7c-7921-431c-b95f-3438724ba16f",
"creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781"
}
}
第 4 步:推送通知
您可以接收转账推送通知,更多详情请参阅我们的推送通知指南。
第 5 步:确认转账完成
您可以调用 Get Balance 端点确认账户是否已更新为正确的金额,或者使用 Find Transactions 端点,并将操作设置为 'transfer',确认转账指令已执行。