Payment pages feature allows creating hosted payment page application for receiving credit card payments on the merchant's website.
To create a new payment page click Create new and fill in the required fields following the sections:
1. General is a section with the general API settings of the payment page.
FIELD | DESCRIPTION |
Payment page name | The payment page name |
Website URL | The website URL, it should contain https protocol. |
Test success URL |
Test URL to which a user will be redirected after successful payment, it should contain https protocol. For unique URL add to code the parameter data-success_url="value_of_url" |
Live success URL |
Live URL to which a user will be redirected after successful payment, it should contain https protocol. For unique URL add to code the parameter data-success_url="value_of_url" |
Test decline URL |
Test URL to which a user will be redirected after declined payment, it should contain https protocol. For unique URL add to code the parameter data-decline_url="value_of_url" |
Live decline URL |
Live URL to which a user will be redirected after declined payment, it should contain https protocol. For unique URL add to code the parameter data-decline_url="value_of_url" |
Test callback URL |
Test URL which allows getting a callback after payment, it should contain https protocol. |
Live callback URL | Live URL which allows getting a callback after payment, it must contain https protocol. SSL generated by yourself is not valid. |
Back button URL | URL where user is redirected if he wants to return to previous page, it must contain https protocol. SSL generated by yourself is not valid. |
API KEYS | DESCRIPTION |
Test public key |
Test public key should be used only in the test environment. This key helps to generate the unique signature for your payment application. Click on the button |
Test secret key |
Test secret key should be used only in the test environment. This key helps to generate the unique signature for your payment application. Click on the button |
Live public key |
Live public key uses only in the production environment. This key helps to generate the unique signature for your payment application. Click on the button |
Live secret key |
Live secret key uses only in the production environment. This key helps to generate the unique signature for your payment application. Click on the button |
2. Product to sell is a section which allows creating Fixed, Trial or Subscription product type. Fixed product type may be used for the billing logic without a subscription. Trial and Subscription product types are used to set up a full subscription cycle.
The fields of Fixed product.
FIELD | DESCRIPTION |
Product type | Select Fixed product type for the billing logic without the subscription. |
Custom params |
Allows assigning a unique Id of the product and select countries it will be applied
|
Product name |
Input the name of the product. |
Product description | Input the product description. |
Price | Enter the product price. |
Currency | Select the currency of the product from the list. |
Discount | Enter the discount of the product if applicable. |
Discount in | Select the value of the discount. It can be an amount or percentage value. |
Most popular/Best deal | Tick one of the checkboxes to highlight the product. |
Active | Turn on the toggle button to make a product active. |
The fields of Subscription product.
FIELD | DESCRIPTION |
Product type | Select Subscription product type to set up a post-trial package for subscription billing logic. |
Custom params |
Allows assigning a unique Id of the product and select countries for selling.
|
Product name |
Input the name of the product. |
Product description | Input the product description. |
Price | Enter the product price. |
Currency | Select the currency of the product from the list. |
Discount | Enter the discount of the product if applicable. |
Discount in | Select the value of the discount. It can be an amount or percentage value. |
Length | The period of the Subscription package. |
Period | The value of the period: Month, Week, Day, Year. |
Most popular/Best deal | Tick one of the checkboxes to highlight the product. |
Active | Turn on the toggle button to make a product active. |
The fields of Trial product.
FIELD | DESCRIPTION |
Product type | Select Trial product type to set up an initial package for subscription billing logic. |
Custom params |
Allows assigning a unique Id of the product and select countries it will be applied
|
Product name |
Input the name of the product. |
Product description | Input the product description. |
Price | Enter the product price. |
Currency | Select the currency of the product from the list. |
Length | The period of the trial package. |
Period | The value of the period: Month, Week, Day, Year. |
Post-trial product | Select the name of the Fixed or Subscription product from the list which will be billed after the Trial. We advise to create it prior to the Trial product. |
Most popular/Best deal | Tick one of the checkboxes to highlight the product. |
Active | Turn on the toggle button to make a product active. |
3. The next is Payment methods, a section that allows choosing payment methods on the payment page. At the moment we have only Credit card payment method available.
Click on the toggle button to turn on the Credit card method
For selecting specific countries which will be available on the payment page please press the button
STATUS | DESCRIPTION |
Activated in all available countries | This is default value which allows processing payments in all available countries. |
Choose countries to display on payment widget | Selected countries will be shown on the payment page. |
4. Payment form is a section that allows to create and customize the payment widget.
First of all, click Create new to create the payment widget.
The description of the fields available in the section:
FIELD | DESCRIPTION |
Embed code |
This is a code generated automatically and is ready to use for the integration process. It based on the parameters and settings which has been set up in previous sections. Select from: Pop up, iFrame or Redirect form for your integration. Pay attention, that the value of the signature parameter is already generated. Use the button |
Payment form name | Input the name of the payment page. |
Cardholder info fields | Select the fields for the payment form. Just press on a checkbox near the field and it will be shown on your payment page. |
Functionality |
Select functionality based on the business model. One click- allows a customer to make the second payment just clicking on his payment card on your payment widget without entering it. Rebilling- allows charge the customers repeatedly without entering the card details, only using a token value. |
Upload logo | Allows uploading your business logo on the payment widget. Just click on the button ![]() |
Live CSS Editor |
Allows customizing your payment widget according to your website. Just click on the button |
Restore to default | Click to restore to default all settings of the payment form. |
After completing all the stypes the payment widget is ready to be used on the website.
If you have any questions please contact us at support@maxpay.com.