Available in🇮🇳 India
The Customer Fee Bearer (CFB) model for recurring card payments allows businesses to pass payment gateway fees to the end customer, improving cost transparency and regulatory compliance. With this enhancement, you can implement transparent fee structures where customers bear the payment processing costs.
If you have already integrated with Recurring Payments Cards APIs, you must implement an additional API integration step that calculates fees before creating recurring payments.
Feature RequestThis is an on-demand feature. Please raise a request with our Support team to get this feature activated on your Razorpay account.
Use Cases
The CFB model for Recurring Payments is particularly useful for:- Subscription Services: Monthly or annual subscription billing with transparent fee structures.
- EMI Payments: Instalment-based payments where customers understand the complete cost breakdown.
- Utility Payments: Regular utility bill payments with clear fee transparency.
- Insurance Premiums: Recurring premium payments with upfront fee disclosure.
- Membership Fees: Club or service memberships with transparent cost structures.
Prerequisites
You must have:- An active Razorpay account.
- Existing recurring payment setup with card payments.
Integration Steps
Follow these steps to implement CFB for your recurring card payments:Step 1: Calculate Fees Before Payment Creation
Call Razorpay’scalculate/fees API endpoint with the intended base amount before creating a recurring payment.
Request Parameters
Request Parameters
The transaction amount, expressed in the currency sub-unit, such as paise (in case of INR). For example, for an actual amount of ₹299.35, the value of this field should be
29935.Determines whether the payment is a one-time payment or a recurring payment. Possible values:
1: It is a recurring payment.0: It is a one-time payment.
Determines whether Razorpay should save customer card details as tokens with the card network. Possible values:
1: Razorpay should save customer card details as tokens with the card network. This will work only if explicit customer consent has been received from the customer.0: Razorpay should not save the card details.
Response Parameters
Response Parameters
Total fees amount in rupees. For example,
1.00 for regular UPI or 236.00 for credit card on UPI.Razorpay processing fee in rupees. For example,
1.00 for regular UPI or 200.00 for credit card on UPI.Tax amount on fees in rupees. For example,
0 for regular UPI or 36.00 for credit card on UPI.Total amount including fees in rupees. For example,
101.00 for regular UPI or 336.00 for credit card on UPI.Step 2: Display Fee Breakdown to Customer
Use the Calculate Fee API response to show customers:- Original order amount
- Processing fee (convenience fee)
- Total amount to be charged
Step 3: Update Payment Creation Request
In your payment creation request to Razorpay, use the values from the fee calculation step to ensure:- The correct total amount is presented to the customer.
- The final payment entity reflects the business and customer share as required by policy.
- Proper fee breakup is maintained for compliance.