Tether (USDT) is a US dollar-backed stablecoin issued by Tether Limited.
| Blockchain | Financial instrument type | supportedCorridors value |
|---|---|---|
| Ethereum | ETH_WALLET | ETH_USDT |
| Tron | TRON_WALLET | TRON_USDT |
| Use case | Beneficiary type | Originator type |
|---|---|---|
| B2B | Business | Business |
| B2B2B | Business | Business |
| B2C | Individual | Business |
| B2B2C | Individual | Business |
| C2B2B | Business | Individual |
| C2B2C | Individual | Individual |
When creating a beneficiary identity for USDT payments, provide the following fields. Identity requirements are the same across all supported blockchains. See Create and manage identities for the API workflow.
The required fields depend on whether the beneficiary is a business or an individual.
Applies to B2B, B2B2B, and C2B2B use cases. Submit a business identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
businessName | Required | STRING | 1–140 characters. The legal name of the beneficiary business. |
address.streetAddress | Required | ARRAY of STRING | Each item 1–70 characters. |
address.city | Required | STRING | 1–140 characters. |
address.stateOrProvince | Required | STRING | 1–140 characters. |
address.postalCode | Required | STRING | 3–15 characters. |
address.country | Required | STRING | Two-letter ISO 3166-1 alpha-2 country code. |
registration | Required | ARRAY of OBJECT | Each item: number (3–35 characters) and type (one of INCORPORATION_CERTIFICATE, TAX_ID). At least one registration entry is required. |
Applies to B2C, B2B2C, and C2B2C use cases. Submit an individual identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
firstName | Required | STRING | 1–140 characters. |
lastName | Required | STRING | 1–140 characters. |
address.streetAddress | Required | ARRAY of STRING | Each item 1–70 characters. |
address.city | Required | STRING | 1–140 characters. |
address.stateOrProvince | Required | STRING | 1–140 characters. |
address.postalCode | Required | STRING | 3–15 characters. |
address.country | Required | STRING | Two-letter ISO 3166-1 alpha-2 country code. |
When creating a financial instrument for USDT payouts, set currency: USDT and select the financial instrument type based on the blockchain. See Create and manage financial instruments for the API workflow.
Set financialInstrumentType: ETH_WALLET. Provide the following fields in the ethWallet payment rail object.
| Field | Required | Type | Constraints |
|---|---|---|---|
walletAddress | Required | STRING | Exactly 42 characters. Pattern: ^0x[a-fA-F0-9]+$. The beneficiary's Ethereum wallet address. |
cryptoInstitutionName | Required | STRING | The venue holding the beneficiary's crypto wallet. Supported venues are configured for your account. Contact your Ripple representative for the value to use in this field. |
When you retrieve the financial instrument, the response includes the following read-only fields:
network:ETHEREUMcountry:ZZsupportedCorridors:[ETH_USDT]
Set financialInstrumentType: TRON_WALLET. Provide the following fields in the tronWallet payment rail object.
| Field | Required | Type | Constraints |
|---|---|---|---|
walletAddress | Required | STRING | Exactly 34 characters. Pattern: ^T[1-9A-HJ-NP-Za-km-z]+$ (base58, starts with T). The beneficiary's Tron wallet address. |
cryptoInstitutionName | Required | STRING | The venue holding the beneficiary's crypto wallet. Supported venues are configured for your account. Contact your Ripple representative for the value to use in this field. |
When you retrieve the financial instrument, the response includes the following read-only fields:
network:TRONcountry:ZZsupportedCorridors:[TRON_USDT]
When creating an originator identity for USDT payments, provide the following fields. The required fields depend on whether the originator is a business or an individual.
Applies to B2B, B2B2B, B2B2C, and B2C use cases. Submit a business identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
businessName | Required | STRING | 1–140 characters. |
address.streetAddress | Required | ARRAY of STRING | Each item 1–70 characters. |
address.city | Required | STRING | 1–140 characters. |
address.stateOrProvince | Required | STRING | 1–140 characters. |
address.postalCode | Required | STRING | 3–15 characters. |
address.country | Required | STRING | Two-letter ISO 3166-1 alpha-2 country code. |
Applies to C2B2B and C2B2C use cases. Submit an individual identity.
| Field | Required | Type | Constraints |
|---|---|---|---|
firstName | Required | STRING | 1–140 characters. |
lastName | Required | STRING | 1–140 characters. |
address.streetAddress | Required | ARRAY of STRING | Each item 1–70 characters. |
address.city | Required | STRING | 1–140 characters. |
address.stateOrProvince | Required | STRING | 1–140 characters. |
address.postalCode | Required | STRING | 3–15 characters. |
address.country | Required | STRING | Two-letter ISO 3166-1 alpha-2 country code. |
No additional transaction-level fields are required for USDT payments beyond the standard payment object (quote ID, payer identity, beneficiary identity, financial instrument). See Create a payment for the API workflow.
For the exact fields required for your specific use case and blockchain, use the Payload Schema Utility.