ACH 入金

用于银行转账的 Plaid 集成

我们已与 Plaid 集成，使你能够无缝地将 Plaid 账户链接到 Alpaca。该集成允许你的最终用户通过 Plaid 可信的前端模块即时验证其账户。

利用这一点，你可以代表最终用户生成 Plaid Processor Token，使 Alpaca 能够立即获取用户的银行详细信息，以便在 Alpaca 平台上入金或出金。

你可以使用你的 Plaid 账户并在 Plaid 仪表板中激活 Alpaca 集成。

该集成需要 Plaid API Keys

获取 Plaid Processor Token

Plaid processor token 用于启用 Plaid 与合作伙伴的集成。客户使用 Plaid Link 连接其银行后，可随时生成 processor token。有关创建令牌的详细信息，请参阅使用 Alpaca 的 Plaid Processor Token 页面。

交换令牌

curl -X POST https://sandbox.plaid.com/item/public_token/exchange 
	-H 'Content-Type: application/json' 
	-d '{ 
		"client_id": "PLAID_CLIENT_ID", 
		"secret": "PLAID_SECRET", 
		"public_token": "PUBLIC_TOKEN" 
}'

为特定账户 ID 创建 processor token。

curl -X POST https://sandbox.plaid.com/processor/token/create 
	-H 'Content-Type: application/json' 
	-d '{
		"client_id": "PLAID_CLIENT_ID", 
		"secret": "PLAID_SECRET", 
		"access_token": "ACCESS_TOKEN", 
		"account_id": "ACCOUNT_ID", 
		"processor": "alpaca" 
}'

对于有效请求，API 将返回类似以下的 JSON 响应：

{ 
  "processor_token": "processor-sandbox-0asd1-a92nc", 
  "request_id": "m8MDnv9okwxFNBV" 
}

Processor Token 流程

1. 最终用户使用 Plaid 链接银行账户。
2. Plaid 向你返回 public token。
3. 你将 public token 提交给 Plaid 以换取 access token。
4. 你将 access token 提交到 Plaid 的 /processor/token/create 端点，并收到 Processor Token（特定于 Alpaca）。
5. 你将调用 processor 端点，将 processor token 传递给 Alpaca，以发起支付。要传递 processor token，请使用 ACH relationships 端点（Link）。

示例请求

POST /v1/accounts/{account_id}/ach_relationships

{
  "processor_token": "processor-sandbox-161c86dd-d470-47e9-a741-d381c2b2cb6f"
}

示例响应

{
  "id": "794c3c51-71a8-4186-b5d0-247b6fb4045e",
  "account_id": "9d587d7a-7b2c-494f-8ad8-5796bfca0866",
  "created_at": "2021-04-08T23:01:53.35743328Z",
  "updated_at": "2021-04-08T23:01:53.35743328Z",
  "status": "QUEUED",
  "account_owner_name": "John Doe",
  "nickname": "Bank of America Checking"
}

6. Alpaca 调用 Plaid 使用 processor token 获取账户和路由号码。
7. Alpaca 在内部保存 processor token 及账户和路由号码以供将来使用。Alpaca 使用账户信息创建和处理 NACHA 文件。

*可包含 Auth、Identity、Balance 信息 - 如果 Broker API 想要发起转账，我们使用 transfer 端点。

姓名匹配

Alpaca 要求使用第一方 ACH 关系。当你使用 Plaid processor token 创建 ACH 关系时，Alpaca 会将 Plaid 返回的银行所有者姓名与经纪账户上的所有者姓名进行比较。如果姓名不匹配，关系状态将被设置为 REJECTED，并且无法为该银行链接发起入金或出金。

ACH 状态流程