{"templateId":"markdown","versions":[{"version":"v2026.04","label":"v2026.04","link":"/pt-br/products/payments-direct-2/introduction/concepts/quotes","default":true,"active":true,"folderId":"7e5507fe"},{"version":"v2026.03","label":"v2026.03","link":"/pt-br/products/payments-direct-2/v2026.03/introduction/concepts/quotes","default":false,"active":false,"folderId":"7e5507fe"},{"version":"v2025.11","label":"v2025.11","link":"/pt-br/products/payments-direct-2/v2025.11/introduction/concepts/quotes","default":false,"active":false,"folderId":"7e5507fe"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/pt-BR/products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Cotações","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cotações","__idx":0},"children":["Cotações"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As cotações permitem ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["visualizar o custo total e o resultado de um pagamento proposto antes de iniciá-lo"]},". Uma cotação reflete a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["taxa de câmbio"]},", as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tarifas"]}," e o ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["valor a ser entregue"]}," entre uma moeda de origem e uma de destino, e tem ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["prazo limitado"]}," (as cotações expiram após um período definido). As cotações são centrais no fluxo de pagamento do ","Payments Direct"," e devem ser criadas ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["antes"]}," de você chamar o endpoint de pagamentos."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"o-que-uma-cotação-inclui","__idx":1},"children":["O que uma cotação inclui"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Uma cotação retorna as informações principais de que você precisa para decidir se prossegue com um pagamento, incluindo:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Valores de origem e de destino"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceAmount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destinationAmount"]},"), conforme você solicite a cotação pelo valor de origem ou pelo valor de destino. Os valores são arredondados para o número de casas decimais definido pela norma ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.iso.org/iso-4217-currency-codes.html"},"children":["ISO 4217"]}," para a moeda em questão (por exemplo, 2 para USD/EUR, 0 para JPY/KRW, 3 para BHD/KWD), com arredondamento HALF_UP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Taxa de câmbio ajustada"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adjustedExchangeRate"]},"), que reflete a taxa usada na conversão."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tarifas"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fees"]},"), com o total e itens de detalhamento opcionais."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tributos"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes"]},"), quando aplicáveis (os tributos incidem sobre as tarifas de serviço da Ripple, não sobre o principal)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Timestamps e validade"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiresAt"]},") e um ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["status"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPIRED"]},")."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-as-cotações-se-encaixam-no-fluxo-de-pagamento","__idx":2},"children":["Como as cotações se encaixam no fluxo de pagamento"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Um fluxo típico é:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Criar uma coleção de cotações"]}," para um pagamento proposto. A coleção contém uma cotação para cada payment rail disponível para o corredor."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Selecionar uma cotação"]}," (use o quoteId retornado)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Criar o pagamento"]}," usando as informações da cotação."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Importante"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No ","Payments Direct",", uma cotação precisa ser aceita ou usada antes de expirar. As cotações vencidas são marcadas como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPIRED"]}," e não podem ser usadas para criar pagamentos."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Nota de implementação"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Internamente, os IDs de cotação são usados na criação do pagamento de modo que o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quoteId"]}," utilizado se torna o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentId"]},". Garanta que a sua integração trate os identificadores de cotação de forma consistente nas etapas de cotação → pagamento."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"coleções-de-cotações-vs-cotações","__idx":3},"children":["Coleções de cotações vs. cotações"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A API retorna as cotações em uma coleção de cotações, o que permite a recuperação e a rastreabilidade do evento de cotação. Uma coleção contém uma cotação para cada payment rail disponível para o corredor, e cada cotação indica o seu payment rail, para que você possa comparar as cotações antes de escolher uma."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As cotações são solicitadas com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v3/quotes"]},", que retorna uma cotação por payment rail para que você possa compará-las e escolher o rail que quiser. O rail que você escolher acompanha a cotação até o pagamento."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"expiração-e-status-da-cotação","__idx":4},"children":["Expiração e status da cotação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As cotações têm prazo limitado:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quoteStatus=ACTIVE"]}," significa que a cotação pode ser usada para criar um pagamento."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quoteStatus=EXPIRED"]}," significa que a cotação não é mais válida e precisa ser gerada novamente."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiresAt"]}," para implementar uma lógica no cliente (por exemplo, atualizar a cotação se estiver perto de a cotação expirar)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tributos-nas-cotações-apenas-sobre-tarifas","__idx":5},"children":["Tributos nas cotações (apenas sobre tarifas)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nas jurisdições em que a Ripple precisa cumprir normas de tributos sobre consumo (VAT/GST etc.), as respostas de cotação podem incluir tributos aplicados às tarifas de serviço da Ripple (componentes fixos e variáveis), e não ao valor principal do pagamento."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Aspectos principais:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["O cálculo dos tributos dá transparência de custo antecipada."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Os tributos são calculados sobre a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["parcela das tarifas"]},", não sobre o valor transferido."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Se não houver tributos aplicáveis (ou se o tributo calculado for zero), a API não inclui o objeto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes"]}," na resposta."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoints","__idx":6},"children":["Endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use estes endpoints para criar e recuperar cotações:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/quotes/quote-collection"]}," — cria uma coleção de cotações para um pagamento proposto, com uma cotação para cada payment rail disponível para o corredor."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v3/quotes/quote-collection/{quote-collection-id}"]}," — recupera uma coleção de cotações criada anteriormente."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v3/quotes/{quote-id}"]}," — recupera uma cotação específica por ID."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para um guia passo a passo sobre como solicitar e usar cotações, consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/api-docs/developer-guides/fetch-a-quote-collection"},"children":["Obter uma coleção de cotações"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"modelo-de-financiamento-payincategory","__idx":7},"children":["Modelo de financiamento (payinCategory)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payinCategory"]}," especifica como você financia o pagamento. Os seguintes valores são aceitos:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Valor"},"children":["Valor"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRE_FUNDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento é financiado por um saldo que você depositou previamente na Ripple. Use este valor em modelos de conta com aporte prévio, em que você mantém um saldo de ledger pré-financiado."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_FUNDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento é liquidado por uma fatura em aberto. A Ripple executa o pagamento e depois fatura o valor para você."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JIT_FUNDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O pagamento é financiado just-in-time: você precisa transferir os recursos para a sua conta de ledger da Ripple antes de o pagamento expirar. Consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#pagamentos-financiados-via-jit"},"children":["Pagamentos financiados via JIT"]}," abaixo."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FUNDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Descontinuado."]}," Equivalente a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRE_FUNDING"]},". Não é aceito. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRE_FUNDING"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T_PLUS_ONE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Descontinuado."]}," Equivalente a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_FUNDING"]},". Não é aceito. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_FUNDING"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Aviso de descontinuação"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FUNDED"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T_PLUS_ONE"]}," estão descontinuados. Uma requisição que envie qualquer um desses valores é rejeitada com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USR_025"]},". Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRE_FUNDING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_FUNDING"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JIT_FUNDING"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pagamentos-financiados-via-jit","__idx":8},"children":["Pagamentos financiados via JIT"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando você usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JIT_FUNDING"]},", o pagamento entra no estado ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AWAITING_FUNDING"]}," depois de criado. Você precisa transferir os recursos necessários para a sua conta de ledger da Ripple antes do timestamp ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jitFundingExpiresAt"]}," do objeto de pagamento. Se o financiamento não for recebido a tempo, o pagamento expira e você precisa criar uma nova cotação e um novo pagamento."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para mais informações sobre os estados do pagamento, incluindo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AWAITING_FUNDING"]},", consulte ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/pt-br/products/payments-direct-2/introduction/concepts/payment-lifecycle"},"children":["Ciclo de vida do pagamento"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dados-obrigatórios-para-cotar","__idx":9},"children":["Dados obrigatórios para cotar"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para criar uma coleção de cotações, informe:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quoteAmount"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quoteAmountType"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SOURCE_AMOUNT"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DESTINATION_AMOUNT"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceCurrency"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destinationCurrency"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destinationCountry"]}," para um payout em moeda fiduciária"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payinCategory"]}," (por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRE_FUNDING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT_FUNDING"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JIT_FUNDING"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Opcionalmente, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRail"]},", para solicitar uma cotação para apenas um payment rail"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceCountry"]}," é opcional."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tratamento-de-erros","__idx":10},"children":["Tratamento de erros"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Os erros do Quote Service são padronizados em categorias como:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AUTH_xxx"]}," erros de autorização (token ausente ou inválido)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["USR_xxx"]}," erros de validação (campos da requisição ausentes ou inválidos)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SYS_xxx"]}," falhas internas ou upstream"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Os erros retornam um objeto estruturado com status e um array errors[] (code, title, type, description, timestamp)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"boas-práticas","__idx":11},"children":["Boas práticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SOURCE_AMOUNT"]}," quando o remetente sabe quanto quer enviar."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DESTINATION_AMOUNT"]}," quando o remetente precisa que o beneficiário receba um valor exato."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"exemplo-criar-uma-coleção-de-cotações","__idx":12},"children":["Exemplo: criar uma coleção de cotações"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Requisição"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  https://api.test.ripple.com/v3/quotes/quote-collection \\\n  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"quoteAmount\": 123.45,\n    \"quoteAmountType\": \"SOURCE_AMOUNT\",\n    \"sourceCurrency\": \"USD\",\n    \"destinationCurrency\": \"MXN\",\n    \"sourceCountry\": \"US\",\n    \"destinationCountry\": \"MX\",\n    \"payinCategory\": \"PRE_FUNDING\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resposta (trecho)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"quoteCollectionId\": \"11111111-aaaa-2222-bbbb-222222222222\",\n  \"quotes\": [\n    {\n      \"quoteId\": \"7ea3399c-1234-5678-8d8f-d320ea406630\",\n      \"quoteStatus\": \"ACTIVE\",\n      \"quoteAmountType\": \"SOURCE_AMOUNT\",\n      \"sourceAmount\": 123.45,\n      \"destinationAmount\": 2438.19,\n      \"sourceCurrency\": \"USD\",\n      \"destinationCurrency\": \"MXN\",\n      \"destinationCountry\": \"MX\",\n      \"paymentRail\": \"SPEI\",\n      \"payinCategory\": \"PRE_FUNDING\",\n      \"adjustedExchangeRate\": {\n        \"adjustedRate\": 2\n      },\n      \"fees\": [\n        {\n          \"totalFee\": 12.23,\n          \"feeCurrency\": \"USD\",\n          \"feeBreakdown\": [\n            {\n              \"calculatedFee\": 2.43,\n              \"feeName\": \"Service fee\",\n              \"feeDescription\": \"The service fee charged for this transaction.\"\n            }\n          ]\n        }\n      ],\n      \"taxes\": [\n        {\n          \"totalTaxes\": 5.12,\n          \"taxCurrency\": \"USD\",\n          \"taxBreakdown\": [\n            {\n              \"taxAmount\": 2.43,\n              \"taxName\": \"ISS/ VAT/ GST etc\",\n              \"taxDescription\": \"The service fee tax charged for this transaction.\",\n              \"taxRate\": 5\n            }\n          ]\n        }\n      ],\n      \"createdAt\": \"2025-11-02T18:26:00.000123Z\",\n      \"expiresAt\": \"2025-11-02T18:41:00.318123Z\"\n    }\n  ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Cotações","id":"cotações","depth":1},{"value":"O que uma cotação inclui","id":"o-que-uma-cotação-inclui","depth":2},{"value":"Como as cotações se encaixam no fluxo de pagamento","id":"como-as-cotações-se-encaixam-no-fluxo-de-pagamento","depth":2},{"value":"Coleções de cotações vs. cotações","id":"coleções-de-cotações-vs-cotações","depth":2},{"value":"Expiração e status da cotação","id":"expiração-e-status-da-cotação","depth":2},{"value":"Tributos nas cotações (apenas sobre tarifas)","id":"tributos-nas-cotações-apenas-sobre-tarifas","depth":2},{"value":"Endpoints","id":"endpoints","depth":2},{"value":"Modelo de financiamento (payinCategory)","id":"modelo-de-financiamento-payincategory","depth":2},{"value":"Pagamentos financiados via JIT","id":"pagamentos-financiados-via-jit","depth":3},{"value":"Dados obrigatórios para cotar","id":"dados-obrigatórios-para-cotar","depth":2},{"value":"Tratamento de erros","id":"tratamento-de-erros","depth":2},{"value":"Boas práticas","id":"boas-práticas","depth":2},{"value":"Exemplo: criar uma coleção de cotações","id":"exemplo-criar-uma-coleção-de-cotações","depth":2}],"frontmatter":{"seo":{"title":"Cotações"}},"lastModified":"2026-10-21T05:24:20.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/payments-direct-2/introduction/concepts/quotes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}