As a user I would like to be able to process a payment

[FredSoares]

Description

Once a user has configured the module with their credentials (#6 ) they should be able to process payments.

• Create a function that should generate the payment form. This function should be generated Fingerprint to ensure that the data has not been altered upon submission, thus providing better security for payment processing. To find out how to do this, see the official documentation. And after that should generate and return the HTML form to process payments.

/**
 * GENERATE PAYMENT REQUEST FORM
 * @param {String} referenceId - Required - This is the payment reference. In this case, we need to know which payment was processed when the SISP returns the payment response.
 * @param {Number} total - Required - This is the amount SISP should process the payment.
 * @param {String} webhookUrl - Required - This is the URL the user should be contacted by SISP for payment response.
 * @returns {Document} response - HTML Form to process payments 
 */
generatePaymentRequestForm(referenceId, total, webhookUrl)

Note:

• webhookUrl should be used to process payment response on As a User I want to know if SISP payment was processed with success or not #10
• Let's add all documentation here before committing.

Testing Requirements

• Ensure all criteria outlined in this ticket is tested.

Documentation/README

Function to generate Payment Request Form.

Function signature.

generatePaymentRequestForm(referenceId, total, webhookUrl);

Function parameters.

String referenceId - Required - This is the payment reference that allow us to know which payment was processed when the SISP returns the payment response.

Number total - Required - This is the amount SISP should process the payment.

String webhookUrl - Required - This is the URL the user should be contacted by SISP for payment response.

Note - webhookUrl should be created by the user as requested by SISP in their official documentation and the SISP will use it to make a request to send us a payment response.

Function return types.

return HTMLDocument - HTML form to process payments 

Usage example.

1. Import SISP in your file that you want to process payment

 const sisp = require('sisp');

2. Configure SISP payments with your credentials

const posID = 900512;
const posAutCode = "123456789ssA";

const sisp = new Sisp({ posID, posAutCode });

3. Generate the HTML Form to process payment

// Example
const referenceId = '123abc';
const total = 1200;
const webhookUrl ='https://chuva.io/payment-response'
const htmlForm = await sisp.generatePaymentRequestForm(referenceId, total, webhookUrl);