此组别内的文章

查看更多

向收款人进行简单付款

  • 更新

工作流程图

主账户

收款人和支付（创建新收款人时）

收款人和支付

收款人和支付

使用现有收款人时

收款人和支付

子账户（代表操作）

收款人和支付 - 代表操作（创建新收款人时）

收款人和支付

收款人和支付 - 代表操作（使用现有收款人时）

收款人和支付

 

集成指南

支付是指从付款人账户转账到收款人账户的资金转移。

支付不能以一种货币进行并以另一种货币接收。要向某个收款人支付特定货币，付款人必须持有该货币的资金。如果需要，付款人必须先将资金从一种货币兑换成另一种货币，然后再进行支付。

在本指南中，您将：

  • 查看您以各种外币持有多少资金。
  • 使用您的欧元余额资金向位于德国的收款人支付欧元。

第 1 步：登录

请参阅验证指南，获取开始新 API 会话的说明。

第 2 步：查看可用余额

要查看您拥有多少欧元，请调用 Get Balance /v2/balances/{currency} 端点，传入 EUR 作为第三个 URL 路径参数。

GET /v2/balances/EUR
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2

以下响应显示您的 Currencycloud 主账户中持有 €15,458.12。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "ad6411db-1e00-44fd-b4e8-194c74cf2f83",
  "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
  "currency":"EUR",
  "amount":"15458.12",
  "created_at":"2021-12-10T16:05:20+00:00",
  "updated_at":"2021-12-10T16:05:20+00:00"
}

或者，您可以调用 Find Balances /v2/balances/find 端点，查看您在 Currencycloud 账户中持有的所有外币余额。

GET /v2/balances/find
X-Auth-Token: ea6d13c7bc50feb46cf978d137bc01a2

以下响应显示您在 Currencycloud 主账户中持有 £10,750.00、US$1,500.24 和 €15,458.12。

{
  "balances": [
    {
      "id": "c52128a4-3918-40dc-a92a-7225cef3a4a6",
      "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
      "currency":"GBP",
      "amount":"10750.00",
      "created_at":"2021-12-10T16:05:19+00:00",
      "updated_at":"2021-12-10T16:05:19+00:00"
    },
    {
      "id":"349a2b87-9455-4808-9e68-515daf1f7298",
      "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
      "currency":"USD",
      "amount":"1550.24",
      "created_at":"2021-12-10T16:05:19+00:00",
      "updated_at":"2021-12-10T16:05:19+00:00"
    },
    {
      "id": "ad6411db-1e00-44fd-b4e8-194c74cf2f83",
      "account_id": "d22073a6-4c56-4980-8699-504b0c70003f",
      "currency":"EUR",
      "amount":"15458.12",
      "created_at":"2021-12-10T16:05:20+00:00",
      "updated_at":"2021-12-10T16:05:20+00:00"
    }
  ],
  "pagination": {
    "total_entries":3,
    "total_pages":1,
    "current_page":1,
    "per_page":25,
    "previous_page": -1,
    "next_page": -1,
    "order": "created_at",
    "order_asc_desc": "asc"
  }
}

第 3 步：查看支付要求

Currencycloud 支持两种类型的支付方式：

  • 常规（本地）支付：使用本地银行网络进行支付。常规支付通常在结算日期后的五个工作日内到账。适合用于低价值、非紧急的交易。
  • 优先 (Swift) 支付：使用 Swift 网络进行支付。这种支付方式可以覆盖 212 个国家/地区，95% 的付款在一个工作日内到达。

假设您需要向一家位于德国的供应商进行常规（本地）支付。您的欧元余额足够支付该笔款项，因此无需提前充值欧元余额。

首先，查看以欧元向在德国拥有银行账户的收款人进行常规（本地）支付需要哪些详细信息。为此，您可以调用 Get Beneficiary Requirements  /v2/reference/beneficiary_required_details 端点。

GET /v2/reference/beneficiary_required_details
参数名称 参数类型 示例值
currency 查询字符串 EUR
bank_account_country 查询字符串 DE
X-Auth-Token 标头 ea6d13c7bc50feb46cf978d137bc01a2

以下响应告诉我们，要向德国银行账户进行常规欧元支付，我们需要以下两项信息：收款人的 IBAN 和 BIC/Swift 号码。收款人可以是公司或个人。无论是哪种，都需要相同的信息。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "details": [
    {
      "payment_type": "priority",
      "beneficiary_entity_type": "individual",
      "beneficiary_address": "^.{1,255}",
      "beneficiary_city": "^.{1,255}",
      "beneficiary_country": "^[A-z]{2}$",
      "beneficiary_first_name": "^.{1,255}",
      "beneficiary_last_name": "^.{1,255}",
      "iban": "([A-Z0-9]\\s*){15,34}",
      "bic_swift": "^[0-9A-Z]{8}$|^[0-9A-Z]{11}$"
    },
    {
      "payment_type": "priority",
      "beneficiary_entity_type": "company",
      "beneficiary_address": "^.{1,255}",
      "beneficiary_city": "^.{1,255}",
      "beneficiary_country": "^[A-z]{2}$",
      "beneficiary_company_name": "^.{1,255}",
      "iban": "([A-Z0-9]\\s*){15,34}",
      "bic_swift": "^[0-9A-Z]{8}$|^[0-9A-Z]{11}$"
    },
    {
      "payment_type": "regular",
      "iban": "([A-Z0-9]\\s*){15,34}",
      "bic_swift": "^[0-9A-Z]{8}$|^[0-9A-Z]{11}$",
      "beneficiary_entity_type": "individual"
    },
    {
      "payment_type": "regular",
      "iban": "([A-Z0-9]\\s*){15,34}",
      "bic_swift": "^[0-9A-Z]{8}$|^[0-9A-Z]{11}$",
      "beneficiary_entity_type": "company"
    }
  ]
}

第 4 步：添加收款人

如果您是赞助或财政服务模型的客户，并与 The Currency Cloud Limited 签订合同，那么您必须先验证收款人的账户详细信息，才能创建收款人。

如果您已了解所需信息，可以通过 Create Beneficiary /v2/beneficiaries/create 端点创建收款人记录。

POST /v2/beneficiaries/create
Content-Type: multipart/form-data

如果收款人成功创建，则响应消息将包含在您的 Currencycloud 账户中记录的收款人完整详细信息。请注意收款人的唯一 ID (id)。在下一步中，您将需要此 ID 来向收款人支付。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "aea097c2-39e4-49b5-aaa6-c860ca55ca0b",
  "bank_account_holder_name":"Acme GmbH",
  "name":"Acme GmbH",
  "email": null,
  "payment_types": [
    "regular"
  ],
  "beneficiary_address": [],
  "beneficiary_country":"DE",
  "beneficiary_entity_type": null,
  "beneficiary_company_name": null,
  "beneficiary_first_name": null,
  "beneficiary_last_name": null,
  "beneficiary_city": null,
  "beneficiary_postcode": null,
  "beneficiary_state_or_province": null,
  "beneficiary_date_of_birth": null,
  "beneficiary_identification_type": null,
  "beneficiary_identification_value": null,
  "bank_country":"DE",
  "bank_name":"Test Bank Plc",
  "bank_account_type": null,
  "currency":"EUR",
  "account_number": null,
  "routing_code_type_1": null,
  "routing_code_value_1": null,
  "routing_code_type_2": null,
  "routing_code_value_2": null,
  "bic_swift":"COBADEFF",
  "iban":"DE89370400440532013000",
  "default_beneficiary": "false",
  "creator_contact_id":"1993263d-be07-42d4-b75b-ae4ea18bcb6c",
  "bank_address": [],
  "created_at":"2021-02-02T11:52:23+00:00",
  "updated_at":"2021-02-02T11:52:23+00:00",
  "beneficiary_external_reference": null
}

第 5 步：进行支付

通过调用 Create Payment /v2/payments/create 端点授权支付。或者，您可以提供幂等键（通过 unique_request_id 参数）。这有助于防止意外重复付款。

POST /v2/payments/create\
Content-Type: multipart/form-data
参数名称 参数类型 示例值
currency 表单数据 EUR
beneficiary_id 表单数据 aea097c2-39e4-49b5-aaa6-c860ca55ca0b
amount 表单数据 10000
reason 表单数据 Invoice Payment
payment_type 表单数据 regular
reference 表单数据 2021-014
unique_request_id 表单数据 4abd730f-bb50-4b4a-8890-f46addff222b
X-Auth-Token 标头 ea6d13c7bc50feb46cf978d137bc01a2

如果支付成功排入队列，则响应负载将包含在您的 Currencycloud 账户中记录的支付完整详细信息。这并不意味着付款已经完成，而是表示付款已准备好进行处理。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "bea05ec4-8c6b-4ec9-80e5-65c0cd257473",
  "amount":"10000.00",
  "beneficiary_id": "aea097c2-39e4-49b5-aaa6-c860ca55ca0b",
  "currency":"EUR",
  "reference":"2021-014",
  "reason":"Invoice Payment",
  "status": "ready_to_send",
  "creator_contact_id":"1993263d-be07-42d4-b75b-ae4ea18bcb6c",
  "payment_type": "regular",
  "payment_date":"2021-02-02",
  "transferred_at": "",
  "authorisation_steps_required":"0",
  "last_updater_contact_id":"1993263d-be07-42d4-b-b-ae4ea18bcb6c",
  "short_reference":"180202-RDRWGQ001",
  "conversion_id": null,
  "failure_reason": "",
  "payer_id":"49d44eff-af91-45b0-a32e-84c7c1750ca0",
  "payer_details_source": "account",
  "created_at":"2021-02-02T11:56:05+00:00",
  "updated_at":"2021-02-02T11:56:05+00:00",
  "payment_group_id": null,
  "unique_request_id":"4abd730f-bb50-4b4a-8890-f46addff222b",
  "failure_returned_amount":"0.00",
  "ultimate_beneficiary_name": null
}

付款按照“先到先处理”的顺序进行处理。Currencycloud 会在指定的 payment_date 处理付款，前提是您以相关货币持有足够的资金。

一旦支付被释放，收款人记录将被克隆，而克隆版本将变为只读。更多详情，请参阅我们的保留收款人详情文章。

这篇文章有帮助吗？
0 人中有 0 人觉得有帮助
返回页首

相关文章