Add Phone Number Field to Payment Request for Phone-Based Payment Channels

[maniamartial]

Description:

Currently, the Payment Request doctype in ERPNext lacks a dedicated field for capturing the phone number when the payment channel is phone-based. This enhancement proposes adding a Phone Number field to the Payment Request, which will be applicable when the selected payment channel is Phone.

This feature will be particularly useful for scenarios where phone-based payments, such as Mpesa STK Push, are used. By capturing the payer's phone number directly in the Payment Request, the system can streamline payment processing by enabling real-time STK push to the specified phone number.

Benefits:

1. Enhanced Payment Experience:

   • Enables capturing the payer's phone number directly in the Payment Request.
   • Facilitates real-time payment requests for phone-based channels, such as Mpesa.

2. Improved Integration:

   • Adds flexibility to use phone-based payments across modules like Webshop and POS Standards.
   • Makes it easier to integrate ERPNext with local payment gateways that rely on phone numbers.

3. Use Case Coverage:

   • Improves the utility of the Payment Request for users in regions where mobile payment systems are dominant.

Implementation:

• Frontend:

  • Add a Phone Number field to the Payment Request doctype.
  • Conditionally display the Phone Number field when the payment channel is set to Phone.

• Backend:

  • Validate the phone number format during submission.
  • Ensure the phone number is passed to the appropriate payment gateway for processing.

Compatibility:

This feature is backward-compatible and will not affect existing functionality. The Phone Number field will only be visible and required when the payment channel is set to Phone.