USD Coin (USDC) is a US dollar-backed stablecoin issued by Circle.
| Blockchain | Financial instrument type | supportedCorridors value |
|---|---|---|
| Ethereum | ETH_WALLET | ETH_USDC |
| Solana | SOL_WALLET | SOLANA_USDC |
| 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 USDC 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 USDC payouts, set currency: USDC 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_USDC]
Set financialInstrumentType: SOL_WALLET. Provide the following fields in the solWallet payment rail object.
| Field | Required | Type | Constraints |
|---|---|---|---|
walletAddress | Required | STRING | 32–44 characters. Pattern: ^[1-9A-HJ-NP-Za-km-z]+$ (base58). The beneficiary's Solana 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:SOLANAcountry:ZZsupportedCorridors:[SOLANA_USDC]
When creating an originator identity for USDC 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 USDC 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.