Yape on File

About this Guide

This page explains how the subscription model works using the One click Payment (OCP) framework. This payment method allows users to provide a single, secure consent (tokenized and stored) to authorize future charges without needing to reapprove each transaction.

Supported Subscription Types

  • ON_DEMAND: Enables merchants to initiate charges at any time after the customer has authorized the subscription.
  • RECURRENT: Intended for automated periodic payments (e.g., monthly billing cycles).

Note: Although the platform supports both types, only ON_DEMAND is enabled in the current version. Support for RECURRENT will be introduced in future releases.

The OCP architecture is designed to be modular, secure, and scalable, enabling merchants and processors to adopt a standardized subscription flow easily and efficiently.

Supported Devices

  • MOBILE: Flow initiated from a mobile device.
  • WEB: Flow initiated from a desktop or web browser.

Supported Processors

ProcessorProcessorCodeDescription
Yape OCPYape_wltFirst wallet integrated under the One Card File (OCP) model. Enables on-demand payments through a single consent, stored securely.

How It Works

Flow

1.- Confirms the subscription request on the Merchant website or App.
2.- Merchant sends a subscription creation request to Monnet.
3.- Monnet forwards the request to the configured processor.
4.- Request customer authorization.
5.- Processor authorizes or rejects the subscription.
6.- Monnet sends final notification to the Merchant.

🔗 Related Links

The Yape On File integration requires interaction with the following methods and components:

  • 🔧 Create Subscription
    Endpoint used to register a recurring payment subscription for the end user.

  • 🗑️ Cancel Subscription
    Endpoint to cancel an existing subscription.

  • 🔁 Webhook
    Used to receive status updates for subscription events (success, cancellation, failure).

  • 🧱 White Label
    Describes the required white label implementation to embed the Yape user experience in mobile and desktop channels.