Simple Checkout

Overview

Welcome to the SIMPLE CHECKOUT documentation.

A Simple Checkout Link is a streamlined method for merchants to accept online payments without the need for complex integrations or extensive programming knowledge. This link directs customers to a secure payment page hosted by ifthenpay, where they can easily complete their transactions.

If you’re not familiar with programming, use this method to easily sell your products or receive payments.

You will need an 'GATEWAY KEY' provided by ifthenpay, assigned to your merchant account. If you do not have this 'GATEWAY KEY', please contact ifthenpay.

You can also request that the gateway is pre-configured with the specific payment methods you wish to use.

ifthenpay offers free technical support to all customers through the following channels:

« go to index

Explanation

To set up a Simple Checkout Link for processing payments, please use the following endpoint format:

URL Structure:
https://gateway.ifthenpay.com/?token=[TOKEN]&id=[ID]&amount=[AMOUNT]&description=[DESCRIPTION]&expire=[EXPIRE]&lang=[LANG]

Example:

                    https://gateway.ifthenpay.com/?token=NRHP-946826&id=10501&amount=10.50&description=Order No. 2010501&expire=20291029&lang=PT
                  

Parameters and Descriptions:

token (required): Description: Access key for the payment gateway Parameter: GATEWAY KEY
id (required): Description: Unique identifier for the order Parameter: ORDER ID
amount (required): Description: Payment amount in the format XX.XX Parameter: AMOUNT
description (optional): Description: HTML-friendly description of the order Parameter: DESCRIPTION
lang (optional): Description: Language for the interface. Accepted values: PT (Portuguese), EN (English), ES Parameter: LANGUAGE
expire (optional): Description: Payment expiration date in YYYYMMDD format Parameter: EXPIRATION DATE

Additional Optional Parameters:

btn_close_url (optional): Description: URL for the "Close" button
btn_close_label (optional): Description: Text label for the "Close" button
accounts (optional): Description: Specifies accounts to be used in the format `ENTITY1|SUBENTITY1;ENTITY2|SUBENTITY2...
success_url (optional): Description: Redirect URL upon successful payment
cancel_url (optional): Description: Redirect URL for canceled payments
return_url (optional): Description: URL for returning to the website after completing the payment process
error_url (optional): Description: URL to redirect in case of a payment error
selected_method (Optional): Description: Specifies the payment method tab to open by default - 1: Multibanco - 2: MBWAY - 3: Payshop - 4: Credit Card - 7: Cofidis Pay - 8: PIX Example usage: selected_method=2:
iframe (Optional): Description: Use this parameter if you need to display the link within an iframe. - true: enables iframe usage - false: disables iframe usage Example usage: iframe=true

Implementation Example

In this example, we demonstrate how to create a payment option using the Simple Checkout Link. This approach allows you to easily integrate payment processing into your website without the need for complex API setups.

Button:

You can create a button that, when clicked, redirects users to the payment page. This button utilizes the Simple Checkout Link format. Here’s an example:

<a href="https://gateway.ifthenpay.com/?token=NRHP-946826&id=10501&amount=10.50&description=Order+No.+2010501&expire=20251029&lang=EN" target="_blank">
<button style="padding: 10px 20px; font-size: 16px; cursor: pointer;">Pay Now</button>
</a>

This code will display a button labeled "Pay Now" that opens the payment page in a new tab when clicked.

Link:

Similarly, you can create a hyperlink that takes the user to the payment page. Here’s how to set up the link:

<a href="https://gateway.ifthenpay.com/?token=NRHP-946826&id=10501&amount=10.50&description=Order+No.+2010501&expire=20251029&lang=EN" target="_blank">Pay Now</a>

This will display a clickable text link that users can follow to complete their payment.

Pay Now

Conclusion

Both the button and the link utilize the same Simple Checkout URL structure, which includes necessary parameters such as the payment token, order ID, amount, and description. By implementing these options on your site, you provide a straightforward and efficient way for customers to process their payments.