O Ripple USD (RLUSD) é uma stablecoin lastreada em dólar norte-americano emitida pela Ripple.
| Blockchain | Tipo de instrumento financeiro | Valor de supportedCorridors |
|---|---|---|
| Ethereum | ETH_WALLET | ETH_RLUSD |
| 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 RLUSD, informe os campos a seguir. 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 RLUSD, defina financialInstrumentType: ETH_WALLET e currency: RLUSD. Informe os campos a seguir no objeto de payment rail ethWallet. Consulte Criar e gerenciar instrumentos financeiros para conhecer o fluxo da API.
| 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:ZZ(código de uso livre do ISO 3166-1, usado porque carteiras de criptomoedas não têm jurisdição de país)supportedCorridors:[ETH_RLUSD]
Ao criar uma identidade de ordenante para pagamentos em RLUSD, 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 RLUSD 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 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.