Skip to content

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.

You can access Ripple Payments Direct through:

  • Ripple Payments UI: a purpose-built web application for creating, managing, and tracking payments.
  • Ripple Payments Direct 2.0 API: a REST API for programmatic integration into your own systems.

How it works

A typical Ripple Payments Direct payment follows these steps:

  1. 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.
  2. Request a quote: Get a real-time view of the exchange rate, fees, and deliverable amount for your proposed payment.
  3. Submit the payment: Create the payment using the accepted quote.
  4. Track the payment: Monitor status as your payment moves through its lifecycle: Initiated → Validating → Transferring → Completed.

For a step-by-step walkthrough, see Create a payment.

Use cases

Ripple Payments Direct supports six use case types, covering direct and intermediated payment flows for both business and individual parties:

Use caseDescription
B2BYour organization sends funds directly to another business.
B2CYour organization sends funds directly to an individual.
B2B2BYour organization sends funds to a business on behalf of a business customer.
B2B2CYour organization sends funds to an individual on behalf of a business customer.
C2B2BYour organization sends funds to a business on behalf of an individual customer.
C2B2CYour organization sends funds to an individual on behalf of an individual customer.

Payout network

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.

For the full list of supported corridors and use case availability by country and currency, see Payout network.

Key features

  • Real-time quotes: Preview exchange rates, fees, and deliverable amounts before committing to a payment.
  • Compliance built-in: Ripple handles sanctions screening, AML checks, and corridor-specific regulatory requirements, including purpose codes and enhanced due diligence where required.
  • Reusable identities: With Identity Management v3, store originator and beneficiary records once and reference them across payments, reducing PII handling in each request.
  • Multiple access methods: Operate through the Ripple Payments UI UI or integrate directly via the Ripple Payments Direct 2.0 API.
  • Payment tracking and webhooks: Monitor each payment through its lifecycle with real-time status updates and webhook notifications for key state transitions.
  • Batch payments: Submit multiple payments in a single batch file using Ripple Payments UI.

Core concepts

To build your integration, start with these core concepts:

  • Payment identities: Structured records representing originators and beneficiaries in a payment.
  • Financial instruments: Bank account and wallet details associated with an identity.
  • Quotes: Real-time pricing for a proposed payment, including exchange rate, fees, and taxes.
  • Payment states: The lifecycle stages a payment moves through from initiation to completion.

Getting started

To use Ripple Payments Direct:

  1. Sign a service agreement with Ripple.
  2. Work with your Ripple representative to configure your corridors and access.
  3. Set up your users and API credentials in Ripple Payments UI, see Getting started.
Contact sales

If you're interested in getting started with Ripple Payments Direct, use the Contact the Sales Team form.