Skip to main content

Outbound Wire Transfers

A wire transfer moves coins from a Figure Pay account to a bank account.

Register a receiving bank account​

Register a bank account to receive a wire transfer. Provide an end-user profile, the name and address of the bank account holder and bank account details.

Request

POST /wire-accounts

{
  "id": "19db289a-278d-4f0b-ada2-813027e522fb",
  "profile_id": "75d52d61-ed02-4b51-8b42-1bc6b3b05ef1",
  "account_holder_name": {
    "business": "First Business"
  },
  "account_holder_address": {
    "street1": "26 Acacia Street",
    "city": "Hattiesburg",
    "state": "MS",
    "zip": "39401"
  },
  "account_number": "27614012",
  "routing_number": "019937999",
  "bank_name": "First Bank",
  "bank_mailing_address": {
    "street1": "6 Homewood Drive",
    "city": "Oakland Gardens",
    "state": "NY",
    "zip": "11364"
  },
  "transfer_instructions": "Wire transfer from example@figure.com"
}

Create a wire transfer​

Create an outbound wire transfer from a Figure Pay account to a registered bank account.

Request

POST /transactions/wire

{
  "account_id": "ddac8cae-351c-4921-bc3d-185fc3ad2d4e",
  "amount_coins": "500000",
  "bank_account_id": "9bd664f4-fc5e-469b-a2e1-6099ee21f97c",
  "transaction_id": "0ee70d60-807e-41f3-9a65-bf2b207c229e"
}

Get a registered bank account​

Retrieve details about a registered bank account.

Request

GET /wire-accounts/:wire-account-id

Get all bank accounts registered to a profile​

Retrieve details about all bank accounts registered to a profile.

Request

GET profiles/:profile-id/wire-accounts