# Creates a new recipient using Wire transfer.

Create a counterparty (payee) for wire payments. Supports both domestic
and international wire transfers. Provide partnerId, merchantId, and wire details.

Endpoint: POST /finance/v1/recipient-wire
Security: Bearer

## Request fields (application/json):

  - `email` (string, required)
    (Required) Email address of the counterparty.

  - `name` (string, required)
    (Required) Full legal name of the counterparty.

  - `phone` (string)
    (Optional) Contact phone number.

  - `type` (string)
    (Optional) Counterparty type.
    Enum: "INDIVIDUAL", "BUSINESS"

  - `paymentMethodType` (string, required)
    (Required) Payment method type.
    Enum: "DOMESTIC_WIRE", "INTERNATIONAL_WIRE"

  - `partnerId` (integer, required)
    (Required) Assigned partner ID.

  - `merchantId` (integer, required)
    (Required) Merchant ID under which the payee is created.

  - `wire` (object, required)

  - `wire.receiverRoutingNumber` (string, required)
    (Required) Receiver routing number.

  - `wire.beneficiaryAccountNumber` (string, required)
    (Required) Beneficiary’s bank account number.

  - `wire.beneficiaryFIName` (string, required)
    (Required) Beneficiary financial institution name.

  - `wire.type` (string, required)
    (Required) Type of wire transfer.
    Enum: "DOMESTIC", "INTERNATIONAL"

  - `wire.receiverShortName` (string,null)
    (Optional) Short name for receiver.

  - `wire.beneficiaryFIIdType` (string, required)
    (Required) Beneficiary financial institution ID type.
    Enum: "ABA", "BIC"

  - `wire.beneficiaryIdNumber` (string,null)
    (Optional) Beneficiary ID number (TIN/EIN/etc.).

  - `wire.intermediaryFIName` (string,null)
    (Optional) Intermediary financial institution name.

  - `wire.intermediaryFIIdNumber` (string,null)
    (Optional) Intermediary FI ID number.

  - `wire.intermediaryFIIdType` (string,null)
    (Optional) Intermediary FI ID type.
    Enum: "ABA", "BIC"

  - `wire.intermediaryFIAddress` (object)

  - `wire.intermediaryFIAddress.city` (string, required)
    City name.

  - `wire.intermediaryFIAddress.countryCode` (string, required)
    ISO country code.

  - `wire.intermediaryFIAddress.line1` (string, required)
    Primary street line.

  - `wire.intermediaryFIAddress.line2` (string,null)
    (Optional) Secondary street line.

  - `wire.intermediaryFIAddress.postalCode` (string, required)
    Postal or ZIP code.

  - `wire.intermediaryFIAddress.state` (string, required)
    State or province code.

  - `wire.intermediaryFIAddress.type` (string)
    (Optional) Address type.
    Enum: "RESIDENCE", "MAILING", "BUSINESS"

  - `wire.address` (object, required)

  - `wire.beneficiaryFIAddress` (object)

## Response 200 fields (application/json):

  - `email` (string)

  - `name` (string)

  - `phone` (string)

  - `type` (string)

  - `paymentMethodType` (string)

  - `partnerId` (integer)

  - `merchantId` (integer)

  - `wire` (object)

  - `wire.receiverRoutingNumber` (string)

  - `wire.beneficiaryAccountNumber` (string)

  - `wire.beneficiaryFIName` (string)

  - `wire.receiverShortName` (string)

  - `wire.beneficiaryFIIdType` (string)

  - `wire.beneficiaryIdNumber` (string)

  - `wire.intermediaryFIName` (string)

  - `wire.intermediaryFIIdNumber` (string)

  - `wire.intermediaryFIIdType` (string)

  - `wire.intermediaryFIAddress` (object)

  - `wire.intermediaryFIAddress.city` (string)

  - `wire.intermediaryFIAddress.countryCode` (string)

  - `wire.intermediaryFIAddress.line1` (string)

  - `wire.intermediaryFIAddress.line2` (string)

  - `wire.intermediaryFIAddress.postalCode` (string)

  - `wire.intermediaryFIAddress.state` (string)

  - `wire.address` (object)

  - `wire.beneficiaryFIAddress` (object)


## Response 400 fields

## Response 401 fields

## Response 500 fields