Lipwa Link

Overview

When you create an account on UpesiPay, you are provided with a unique Lipwa link. This link allows you to receive payments directly into your linked MPESA Paybill, Till, or bank account. You can share this link with your customers online, making it easy and seamless for them to pay you.

Customizing Your Lipwa Link

Your Lipwa link can be customized to include pre-filled payment details, saving your customers from the hassle of manually entering the information. To customize your link, you can pass the following parameters:

  • amount - The payment amount to be pre-filled on the payment form
  • phone - The customer's phone number
  • name - The customer's name
  • channel_id - The payment channel ID from your UpesiPay payment channels
  • reference - A reference or description for the payment
  • success_url - A URL where the customer will be redirected after successful payment
  • failed_url - A URL where the customer will be redirected in case the payment fails

By including these parameters in your Lipwa link, the payment form will automatically populate with the relevant details. This ensures a smooth and efficient payment process for your customers, eliminating the need for manual data entry.

Example

Here's an example of a customized Lipwa link:

https://upesipay.com/lipwa/5?amount=500&phone=254712345678&name=JohnDoe&channel_id=100&reference=Invoice123&success_url=https://yourwebsite.com/success&failed_url=https://yourwebsite.com/failed

With this link:

  • The amount is pre-filled as 500
  • The customer's phone number is set to 254712345678
  • The name is set to John Doe
  • The payment channel is identified as 100
  • The reference is set to Invoice123
  • The customer will be redirected to https://yourwebsite.com/success after a successful payment
  • In case of a failed payment, the customer will be redirected to https://yourwebsite.com/failed

Tip: You can use a service like https://www.shorturl.at/ to create a short URL and share it with your customers.

Was this page helpful?

Previous

Learn how to integrate payment buttons for simple payment collection.

Payment Button

Next

Learn how to handle payment callbacks and webhooks from UpesiPay.

Payment Callback