Payment parameters

The tables below detail the required fields for making a Zelle® payment. You must include all required fields for your request to be successful. You can add optional fields when needed for additional functionality.

Tip

This page serves as an overview of required fields. For detailed JSON specifications when constructing a request, refer to the API specification.

Required fields

Required fields for *Zelle*® payment initiation
JSON field name	Description	Min Length	Max Length
`payments.requestedExecutionDate`	The transaction execution date in ISO Date format (YYYY-MM-DD). This value must be the current day, based on the EST time zone.	10	10
`payments.paymentIdentifiers.endToEndId`	The unique payment identifier assigned by the client.	6	16
`payments.paymentCurrency`	The currency in which the client wants to make the payment. This should be USD.	3	3
`payments.paymentAmount`	The amount for the payment. Numeric characters only, no currency symbol. The amount must be greater than 0.01, with a maximum of two decimal places.	1	18
`payments.transferType`	All Zelle® disbursements transactions must use `CREDIT`.	6	6
`payments.debtor.debtorName`	The sender name. This value will be used as the sender name in the issuer notifications sent to the recipient.	1	50
`payments.debtor.debtorAccount.accountId`	Debtor’s DDA account number (include leading zeros).	1	35
`payments.debtorAgent.financialInstitutionId.bic`	The financial institution identifier of sender. If processing payment in USD: `CHASUS33`.	8	8
`payments.creditor.creditorName`	The name of the recipient. No special characters are allowed.	1	101
`payments.creditor.creditorAccount.accountType`	All Zelle® payments must use `ZELLE`.	5	5
`payments.creditor.creditorAccount.alternateAccountIdentifier`	This is the social alias (email address or phone number) of the recipient.	1	255
`payments.creditor.creditorAccount.schemeName.proprietary`	All Zelle® payments must use `EMAL` for email address or `TELI` for telephone number.	4	4

Optional and conditional fields

Optional and conditional fields for Zelle® remittance information.

Optional and conditional fields for *Zelle*® remittance information
JSON field name	Description	Min Length	Max Length
`payments.remittanceInformation.unstructuredInformation`	Unstructured remittance information for the payment.	1	16
`payments.debtor.ultimateDebtor.ultimateDebtorName`	The name of the ultimate debtor. Required for third-party payment processor (TP3) use cases.	1	20
`payments.creditor.postalAddress.addressType`	This is `ADDR`	1	10
`payments.creditor.postalAddress.streetName`	The street name of the creditor.	1	35
`payments.creditor.postalAddress.buildingNumber`	The building number of the creditor.	1	16
`payments.creditor.postalAddress.postalCode`	The ZIP or postal code of the creditor.	1	9
`payments.creditor.postalAddress.townName`	The city or town of the creditor.	1	25
`payments.creditor.postalAddress.countrySubDvsn`	The state or province of the creditor.	2	3
`payments.creditor.postalAddress.country`	The standard country code of the creditor.	2	2
`payments.purpose.code`	The code that describes the purpose of payment.	1	6

Next steps

Review Zelle® resources.