Payment-Gateway-OpenApi
  1. Pelago Direct Mode
Payment-Gateway-OpenApi
  • Getting Started
  • Fiat Collection
    • Overview
    • Pelago Cashier Mode
      • Cashier Mode Introduction
      • Create Pelago Order
    • Pelago Direct Mode
      • Direct Mode Introduction
      • Get Rate
        POST
      • Get Product
        POST
      • Create Order
        POST
      • Get Order Info
        POST
      • Order Notify
        POST
  • Crypto Collection
    • Overview
    • Create Order
      POST
    • Refund
      POST
    • Withdraw
      POST
  • Common Collection
    • Check Order Info
      POST
  1. Pelago Direct Mode

Direct Mode Introduction

Pelago Gateway Direct Mode#

#

Pelago Gateway Direct Mode is designed for merchants who want to customize their own checkout interface and maintain full control over the payment method selection experience. This integration approach allows merchants to create a seamless, branded checkout flow while leveraging Pelago's comprehensive payment processing capabilities.

How Direct Mode Works#

1. Payment Method Discovery#

#

Merchants can retrieve a list of available payment methods from Pelago
This list can be rendered within the merchant's custom checkout interface
Payment methods are displayed according to the merchant's design preferences

2. Payment Method Selection#

#

Customers select their preferred payment method directly on the merchant's checkout page
The payment method selection remains within the merchant's controlled environment
No redirection to external payment selection pages

3. Payment Request Processing#

#

When a customer selects a payment method, the merchant sends a payment request to Pelago
The request includes:
Order information (amount, currency, order ID, etc.)
Selected payment method identifier
Customer details (if required)

4. Payment Method Validation & Interface Rendering#

#

Pelago validates the availability and compatibility of the selected payment method
If the payment method is available and valid, Pelago renders the appropriate payment interface
The payment interface is returned to the customer for completion

5. Payment Completion & Notification#

Once the payment is successfully processed, Pelago sends notifications to both:
The customer (payment confirmation)
The merchant (payment success webhook/notification)

Key Benefits#

#

Custom Checkout Experience: Full control over the checkout interface design and user experience
Seamless Integration: Payment method selection stays within your application
Flexible Payment Options: Access to Pelago's full range of supported payment methods
Real-time Validation: Instant verification of payment method availability
Comprehensive Notifications: Automated success notifications for both parties
Integration Requirements
To implement Direct Mode, merchants need to:
Integrate the payment methods discovery API
Implement payment request submission
Handle payment interface rendering
Set up webhook endpoints for payment notifications
This mode is ideal for merchants who require maximum customization flexibility while maintaining a consistent brand experience throughout the entire checkout process.
Modified at 2025-06-03 06:49:48
Previous
Create Pelago Order
Next
Get Rate
Built with