O USD Coin (USDC) é uma stablecoin lastreada em dólar norte-americano emitida pela Circle.
| Blockchain | Tipo de instrumento financeiro | Valor de supportedCorridors |
|---|---|---|
| Ethereum | ETH_WALLET | ETH_USDC |
| Solana | SOL_WALLET | SOLANA_USDC |
| Caso de uso | Tipo de beneficiário | Tipo de ordenante |
|---|---|---|
| B2B | Empresa | Empresa |
| B2B2B | Empresa | Empresa |
| B2C | Pessoa física | Empresa |
| B2B2C | Pessoa física | Empresa |
| C2B2B | Empresa | Pessoa física |
| C2B2C | Pessoa física | Pessoa física |
Ao criar uma identidade de beneficiário para pagamentos em USDC, informe os campos a seguir. Os requisitos de identidade são os mesmos em todas as blockchains compatíveis. Consulte Criar e gerenciar identidades para conhecer o fluxo da API.
Os campos obrigatórios dependem de o beneficiário ser uma empresa ou uma pessoa física.
Aplica-se aos casos de uso B2B, B2B2B e C2B2B. Envie uma identidade business.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
businessName | Obrigatório | STRING | De 1 a 140 caracteres. A razão social da empresa beneficiária. |
address.streetAddress | Obrigatório | ARRAY de STRING | Cada item de 1 a 70 caracteres. |
address.city | Obrigatório | STRING | De 1 a 140 caracteres. |
address.stateOrProvince | Obrigatório | STRING | De 1 a 140 caracteres. |
address.postalCode | Obrigatório | STRING | De 3 a 15 caracteres. |
address.country | Obrigatório | STRING | Código de país ISO 3166-1 alfa-2 de duas letras. |
Aplica-se aos casos de uso B2C, B2B2C e C2B2C. Envie uma identidade individual.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
firstName | Obrigatório | STRING | De 1 a 140 caracteres. |
lastName | Obrigatório | STRING | De 1 a 140 caracteres. |
address.streetAddress | Obrigatório | ARRAY de STRING | Cada item de 1 a 70 caracteres. |
address.city | Obrigatório | STRING | De 1 a 140 caracteres. |
address.stateOrProvince | Obrigatório | STRING | De 1 a 140 caracteres. |
address.postalCode | Obrigatório | STRING | De 3 a 15 caracteres. |
address.country | Obrigatório | STRING | Código de país ISO 3166-1 alfa-2 de duas letras. |
Ao criar um instrumento financeiro para pagamentos em USDC, defina currency: USDC e selecione o tipo de instrumento financeiro conforme a blockchain. Consulte Criar e gerenciar instrumentos financeiros para conhecer o fluxo da API.
Defina financialInstrumentType: ETH_WALLET. Informe os seguintes campos no objeto de payment rail ethWallet.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
walletAddress | Obrigatório | STRING | Exatamente 42 caracteres. Padrão: ^0x[a-fA-F0-9]+$. O endereço da carteira Ethereum do beneficiário. |
cryptoInstitutionName | Obrigatório | STRING | A corretora que mantém a carteira de criptomoedas do beneficiário. As corretoras compatíveis são configuradas para a sua conta. Entre em contato com o seu representante Ripple para saber qual valor usar neste campo. |
Ao recuperar o instrumento financeiro, a resposta inclui os seguintes campos somente leitura:
network:ETHEREUMcountry:ZZsupportedCorridors:[ETH_USDC]
Defina financialInstrumentType: SOL_WALLET. Informe os campos a seguir no objeto de payment rail solWallet.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
walletAddress | Obrigatório | STRING | De 32 a 44 caracteres. Padrão: ^[1-9A-HJ-NP-Za-km-z]+$ (base58). O endereço da carteira Solana do beneficiário. |
cryptoInstitutionName | Obrigatório | STRING | A corretora que mantém a carteira de criptomoedas do beneficiário. As corretoras compatíveis são configuradas para a sua conta. Entre em contato com o seu representante Ripple para saber qual valor usar neste campo. |
Ao recuperar o instrumento financeiro, a resposta inclui os seguintes campos somente leitura:
network:SOLANAcountry:ZZsupportedCorridors:[SOLANA_USDC]
Ao criar uma identidade de ordenante para pagamentos em USDC, informe os campos a seguir. Os campos obrigatórios dependem de o ordenante ser uma empresa ou uma pessoa física.
Aplica-se aos casos de uso B2B, B2B2B, B2B2C e B2C. Envie uma identidade business.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
businessName | Obrigatório | STRING | De 1 a 140 caracteres. |
address.streetAddress | Obrigatório | ARRAY de STRING | Cada item de 1 a 70 caracteres. |
address.city | Obrigatório | STRING | De 1 a 140 caracteres. |
address.stateOrProvince | Obrigatório | STRING | De 1 a 140 caracteres. |
address.postalCode | Obrigatório | STRING | De 3 a 15 caracteres. |
address.country | Obrigatório | STRING | Código de país ISO 3166-1 alfa-2 de duas letras. |
Aplica-se aos casos de uso C2B2B e C2B2C. Envie uma identidade individual.
| Campo | Obrigatório | Tipo | Restrições |
|---|---|---|---|
firstName | Obrigatório | STRING | De 1 a 140 caracteres. |
lastName | Obrigatório | STRING | De 1 a 140 caracteres. |
address.streetAddress | Obrigatório | ARRAY de STRING | Cada item de 1 a 70 caracteres. |
address.city | Obrigatório | STRING | De 1 a 140 caracteres. |
address.stateOrProvince | Obrigatório | STRING | De 1 a 140 caracteres. |
address.postalCode | Obrigatório | STRING | De 3 a 15 caracteres. |
address.country | Obrigatório | STRING | Código de país ISO 3166-1 alfa-2 de duas letras. |
Não há campos adicionais em nível de transação obrigatórios para pagamentos em USDC além do objeto de pagamento padrão (ID da cotação, identidade do pagador, identidade do beneficiário, instrumento financeiro). Consulte Criar um pagamento para conhecer o fluxo da API.
Os pagamentos via ETH_WALLET e SOL_WALLET aceitam apenas os seguintes tipos de documento de identidade. As requisições que usam um tipo de documento não listado para o papel de pagamento correspondente são rejeitadas com um erro 400. Quando um papel ou tipo de identidade não está listado abaixo, todos os valores do enum do campo são aceitos.
| Tipo de identidade | Papel de pagamento | Tipos de documento aceitos |
|---|---|---|
Empresa (registration.type) | Beneficiário | INCORPORATION_CERTIFICATE |
Para saber exatamente quais campos são obrigatórios no seu caso de uso e blockchain específicos, use o Utilitário de schema de payload.