> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swipelux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 受取人と送金先

> サードパーティの受取人と、支払いを受け取る銀行またはウォレットのエンドポイントを作成します。

顧客がエンドポイントを所有する場合は、顧客の口座を使用します。他の個人や事業者が資金を受け取る場合は、受取人と送金先を使用します。

受取人は、誰が資金を受け取るかを記録します。送金先は、どこで受け取るかを記録します。

## 1. 受取人を作成する

[`POST /v3/customers/{customerId}/recipients`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients) で個人または事業者を作成します。次のヘッダーを送信します。

```http theme={null}
X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-create-001
Content-Type: application/json
```

```json theme={null}
{
  "type": "individual",
  "relationship": "contractor",
  "firstName": "Jason",
  "lastName": "Swipelux",
  "email": "jason@swipelux.com",
  "phone": "+14155551234",
  "address": {
    "streetLine1": "1 Market Street",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94105",
    "country": "US"
  },
  "label": "Jason contractor"
}
```

フィアット送金先を作成する前に住所を含めてください。返された受取人の `data.id` を `RECIPIENT_ID` として保存し、その現在のステータスを保持してください。

## 2. 送金先を追加する

[`POST /v3/customers/{customerId}/recipients/{recipientId}/destinations`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients-by-recipient-id-destinations) でエンドポイントを作成します。この意図された送金先には新しいキーを使用してください。

```http theme={null}
X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-destination-create-001
Content-Type: application/json
```

<Tabs>
  <Tab title="銀行送金先">
    ```json theme={null}
    {
      "type": "ach",
      "currency": "USD",
      "details": {
        "routingNumber": "021000021",
        "accountNumber": "123456789",
        "accountType": "checking",
        "bankName": "Example Bank",
        "accountHolderName": "Jason Swipelux",
        "country": "US"
      }
    }
    ```
  </Tab>

  <Tab title="ウォレット送金先">
    ```json theme={null}
    {
      "type": "wallet",
      "currency": "USDC",
      "ownership": {
        "type": "self_custodied"
      },
      "details": {
        "network": "base",
        "address": "0x1111111111111111111111111111111111111111"
      }
    }
    ```
  </Tab>
</Tabs>

`self_custodied` は、受取人がそのウォレットを管理している場合にのみ使用してください。別のカストディアンが保有するウォレットの場合は、現在の API リファレンスのバリエーションに従ってください。

返された送金先の `data.id` を `DESTINATION_ID` として保存し、その現在のステータスを保持してください。

## 3. 送金先が ready になるまで待つ

見積もりを作成する前に、[`GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId}`](/api-reference/recipients/get-v3-customers-by-customer-id-recipients-by-recipient-id-destinations-by-destination-id) を読み取ります。

現在の送金先ステータスが支払いを許可し、その通貨、方法、ネットワークが意図する資金移動と一致する場合にのみ続行してください。受取人と送金先のステータスは独立しています。

支払い見積もりでは `dst_` の送金先 ID を使用してください。`rcp_` の受取人 ID は所有者レコードを識別するもので、見積もりの送金先ではありません。

次に、ready 状態の送金先を持って [資金を送る](/jp/integration/send-funds) に進んでください。


## Related topics

- [資金を送る](/jp/integration/send-funds.md)
- [見積もりと送金](/jp/integration/quotes-and-transfers.md)
- [Travel Rule コンプライアンス](/jp/knowledge-base/compliance/travel-rule.md)
- [口座とウォレット](/jp/integration/accounts.md)
- [本番リリース](/jp/integration/go-live.md)