{"templateId":"markdown","versions":[{"version":"v2026.03","label":"v2026.03","link":"/products/payments-direct-2/introduction/ripple-payments-direct","default":true,"active":true,"folderId":"eb16255d"},{"version":"v2025.11","label":"v2025.11","link":"/products/payments-direct-2/v2025.11/introduction/ripple-payments-direct","default":false,"active":false,"folderId":"eb16255d"}],"sharedDataIds":{"sidebar":"sidebar-products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Ripple Payments Direct 2.0","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ripple-payments-direct-20","__idx":0},"children":["Ripple Payments Direct 2.0"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Payments Direct"," is Ripple's cross-border payment service for financial institutions and businesses. With a direct commercial arrangement with Ripple, you can send payments to 60+ destination countries without managing foreign exchange, payout partner relationships, or last-mile delivery logistics. Ripple handles all of that on your behalf."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can access ","Ripple Payments Direct"," through:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ripple Payments UI",":"]}," a purpose-built web application for creating, managing, and tracking payments."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ripple Payments Direct 2.0 API:"]}," a REST API for programmatic integration into your own systems."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":1},"children":["How it works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical ","Ripple Payments Direct"," payment follows these steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create identities and financial instruments:"]}," Register originator and beneficiary records, including verified identity data and bank account or wallet details, that can be reused across payments."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request a quote:"]}," Get a real-time view of the exchange rate, fees, and deliverable amount for your proposed payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit the payment:"]}," Create the payment using the accepted quote."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Track the payment:"]}," Monitor status as your payment moves through its lifecycle: Initiated → Validating → Transferring → Completed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a step-by-step walkthrough, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/api-docs/tutorials/create-a-payment"},"children":["Create a payment"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-cases","__idx":2},"children":["Use cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Payments Direct"," supports six use case types, covering direct and intermediated payment flows for both business and individual parties:"]},{"$$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":"Use case"},"children":["Use case"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["B2B"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your organization sends funds directly to another business."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["B2C"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your organization sends funds directly to an individual."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["B2B2B"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your organization sends funds to a business on behalf of a business customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["B2B2C"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your organization sends funds to an individual on behalf of a business customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["C2B2B"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your organization sends funds to a business on behalf of an individual customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["C2B2C"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your organization sends funds to an individual on behalf of an individual customer."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payout-network","__idx":3},"children":["Payout network"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Payments Direct"," supports payments to 60+ destination countries across Africa, Asia-Pacific, Europe, the Middle East, Latin America, and North America. Ripple manages the full payout partner network on your behalf. You specify the destination and Ripple handles routing and delivery."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full list of supported corridors and use case availability by country and currency, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/introduction/payout-network"},"children":["Payout network"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-features","__idx":4},"children":["Key features"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Real-time quotes:"]}," Preview exchange rates, fees, and deliverable amounts before committing to a payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Compliance built-in:"]}," Ripple handles sanctions screening, AML checks, and corridor-specific regulatory requirements, including purpose codes and enhanced due diligence where required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reusable identities:"]}," With Identity Management v3, store originator and beneficiary records once and reference them across payments, reducing PII handling in each request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Multiple access methods:"]}," Operate through the ","Ripple Payments UI"," UI or integrate directly via the Ripple Payments Direct 2.0 API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment tracking and webhooks:"]}," Monitor each payment through its lifecycle with real-time status updates and webhook notifications for key state transitions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Batch payments:"]}," Submit multiple payments in a single batch file using ","Ripple Payments UI","."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-concepts","__idx":5},"children":["Core concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To build your integration, start with these core concepts:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/api-docs/concepts/payment-identities"},"children":["Payment identities"]},": Structured records representing originators and beneficiaries in a payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/api-docs/concepts/financial-instruments"},"children":["Financial instruments"]},": Bank account and wallet details associated with an identity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/api-docs/concepts/quotes"},"children":["Quotes"]},": Real-time pricing for a proposed payment, including exchange rate, fees, and taxes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/api-docs/concepts/payment-states"},"children":["Payment states"]},": The lifecycle stages a payment moves through from initiation to completion."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"getting-started","__idx":6},"children":["Getting started"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use ","Ripple Payments Direct",":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign a service agreement with Ripple."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Work with your Ripple representative to configure your corridors and access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set up your users and API credentials in ","Ripple Payments UI",", see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/api-docs/getting-started"},"children":["Getting started"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Contact sales"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're interested in getting started with ","Ripple Payments Direct",", use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://ripple.com/contact/sales/"},"children":["Contact the Sales Team"]}," form."]}]}]},"headings":[{"value":"Ripple Payments Direct 2.0","id":"ripple-payments-direct-20","depth":1},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Use cases","id":"use-cases","depth":2},{"value":"Payout network","id":"payout-network","depth":2},{"value":"Key features","id":"key-features","depth":2},{"value":"Core concepts","id":"core-concepts","depth":2},{"value":"Getting started","id":"getting-started","depth":2}],"frontmatter":{"seo":{"title":"Ripple Payments Direct 2.0"}},"lastModified":"2026-03-31T03:43:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-direct-2/introduction/ripple-payments-direct","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}