Skip to main content

​
Overview

Link a Zelle destination (email/username) to enable payouts. Use the application token from your payout link/account widget flow.

​
Prerequisites

  • Application token (from payout/account widget)
  • Valid access token

​
Endpoint

  • POST {{LIQUIDITY_URL}}/v1/ext/application-token/:token/linked-accounts/:currency/link/zelle/:step
  • Auth: Bearer {{accessToken}}

​
Path Parameters

ParameterTypeDescriptionRequired
tokenstringApplication token from payout/account widgetYes
currencystringCurrency code (e.g., USD)Yes
stepstringUsually 1Yes

​
Request

curl -X POST "{{LIQUIDITY_URL}}/v1/ext/application-token/{{token}}/linked-accounts/USD/link/zelle/1" \
  -H "Authorization: Bearer {{accessToken}}" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Pacavel - Zelle #3340",
    "data": {
      "username": "pacavel+zelle@gmail.com"
    }
  }'

​
Request Body Fields

FieldTypeDescriptionRequired
labelstringDisplay name for the accountYes
data.usernamestringZelle username/emailYes

​
Response (200)

{
  "data": {
    "type": "completed",
    "message": "Account successfully linked!",
    "data": {
      "id": "1626d23d-ca7a-49de-b7b9-82d34ae896cb",
      "currency": "USD",
      "optionType": "zelle",
      "counterPartyName": "samuel+zelle@gmail.com",
      "wallet": {
        "id": "3eb8d02c-30e0-497c-a6ac-e2d203c63198",
        "balance": "99817.14",
        "disabled": false
      },
      "entity": { "id": "d5e6f1dd-57bc-4581-98e8-646264a5f2c9", "entityType": "BUSINESS" }
    }
  }
}

​
Response Fields

FieldTypeDescription
data.data.idstringLinked account ID (use for withdrawals)
data.data.currencystringCurrency of the linked account
data.data.optionTypestringAccount type: zelle
data.data.counterPartyNamestringZelle username/email
data.data.wallet.idstringAssociated wallet ID
data.data.wallet.balancestringCurrent wallet balance
data.data.entity.idstringEntity ID associated with the account
data.data.entity.entityTypestringEntity type: USER or BUSINESS

​
Notes

  • Store the id from the response for withdrawals
  • Ensure the Zelle username/email matches the recipient’s Zelle account
  • Uses the same withdrawal endpoint as other linked accounts