# Ativos digitais: RLUSD O Ripple USD (RLUSD) é uma stablecoin lastreada em dólar norte-americano emitida pela Ripple. ## Blockchains compatíveis | Blockchain | Tipo de instrumento financeiro | Valor de `supportedCorridors` | | --- | --- | --- | | Ethereum | `ETH_WALLET` | `ETH_RLUSD` | ## Casos de uso compatíveis | 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 | ## Identidade do beneficiário Ao criar uma identidade de beneficiário para pagamentos em RLUSD, informe os campos a seguir. Consulte [Criar e gerenciar identidades](/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-identities) para conhecer o fluxo da API. Os campos obrigatórios dependem de o beneficiário ser uma **empresa** ou uma **pessoa física**. ### Beneficiário empresa 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. | ### Beneficiário pessoa física 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. | ## Instrumento financeiro do beneficiário 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](/pt-br/products/payments-direct-2/api-docs/developer-guides/create-and-manage-financial-instruments) 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`: `ETHEREUM` - `country`: `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]` ## Identidade do ordenante 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**. ### Ordenante empresa 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. | ### Ordenante pessoa física 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. | ## Campos da transação 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](/pt-br/products/payments-direct-2/api-docs/developer-guides/create-a-payment) para conhecer o fluxo da API. ## Tipos de documento de identidade aceitos 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 | ## Como verificar os requisitos do seu cenário 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](/pt-br/products/payments-direct-2/api-docs/integration-resources/payload-schema-utility).