创建付款

代码示例

1https://connect.squareupsandbox.com/v2/payments

1import fetch from 'node-fetch';
2
3const headerParameters = {
4  'Authorization': 'Bearer {{ACCESS_TOKEN}}',
5  'Content-Type': 'application/json'
6};
7
8const url = new URL('https://connect.squareupsandbox.com/v2/payments');
9
10const bodyParameters = JSON.stringify({
11  'source_id': 'CASH',
12  'idempotency_key': getRandomString(),
13  'amount_money': {
14    'amount': 100,
15    'currency': 'USD'
16  },
17  'cash_details': {
18    'buyer_supplied_money': {
19      'amount': 100,
20      'currency': 'USD'
21    }
22  }
23});
24
25const options = {
26  method: 'POST',
27  headers: headerParameters,
28  body: bodyParameters
29};
30
31async function invokeEndpoint() {
32  try {
33    const response = await fetch(url, options);
34    // 自定义函数用于打印 API 响应
35    printResponse(response);
36  } catch (error) {
37    console.log(`Error: ${err}`);
38  }
39}
40
41invokeEndpoint();

1import fetch from 'node-fetch';
2
3const headerParameters = {
4  'Authorization': 'Bearer {{ACCESS_TOKEN}}',
5  'Content-Type': 'application/json'
6};
7
8const url = new URL('https://connect.squareupsandbox.com/v2/payments');
9
10const bodyParameters = JSON.stringify({
11  'source_id': 'cnon:card-nonce-ok',
12  'idempotency_key': getRandomString(),
13  'amount_money': {
14    'amount': 100,
15    'currency': 'USD'
16  }
17});
18
19const options = {
20  method: 'POST',
21  headers: headerParameters,
22  body: bodyParameters
23};
24
25async function invokeEndpoint() {
26  try {
27    const response = await fetch(url, options);
28    // 自定义函数用于打印 API 响应
29    printResponse(response);
30  } catch (error) {
31    console.log(`Error: ${err}`);
32  }
33}
34
35invokeEndpoint();

ACH 银行转账支付

应用程序可使用 CreatePayment 端点接收自动清算中心（ACH）银行转账支付。当 Square 收到 CreatePayment 请求时，会从指定银行账户扣款，并将资金存入账户的 Square 余额。

要发起 ACH 银行转账支付，可以在上述代码中提供以下任一支付令牌作为 source_id。

除了 Square 直接处理支付外，我们还可以记录在 Square 外部处理的支付。这可以通过现金支付或任何外部支付方式实现。我们已在本课前面讨论过现金支付。接下来了解如何记录外部支付。

外部支付

由外部实体（非 Square 或卖家）完成的支付称为 外部支付。例如，一位买家通过外卖服务下单，该服务收集付款并支付给卖家。其他场景还包括卖家通过加密货币钱包或非 Square 礼品卡收款。卖家可以使用 CreatePayment 记录这些外部支付。

与现金支付不同，我们需将 source_id 设置为 EXTERNAL，同时必须提供 external_details 字段，用于描述外部支付的具体信息。

1import fetch from 'node-fetch';
2
3const headerParameters = {
4  'Authorization': 'Bearer {{ACCESS_TOKEN}}',
5  'Content-Type': 'application/json'
6};
7
8const url = new URL('https://connect.squareupsandbox.com/v2/payments');
9
10const bodyParameters = JSON.stringify({
11  'source_id': 'EXTERNAL',
12  'idempotency_key': getRandomString(),
13  'amount_money': {
14    'amount': 100,
15    'currency': 'USD'
16  },
17  'external_details': {
18    'type': 'OTHER',
19    'source': '外卖配送服务',
20    'source_fee_money': {
21      "amount": 500,
22      'currency': 'USD'
23    }
24  }
25});
26
27const options = {
28  method: 'POST',
29  headers: headerParameters,
30  body: bodyParameters
31};
32
33async function invokeEndpoint() {
34  try {
35    const response = await fetch(url, options);
36    // 自定义函数用于打印 API 响应
37    printResponse(response);
38  } catch (error) {
39    console.log(`Error: ${err}`);
40  }
41}
42
43invokeEndpoint();