API Documentation
Overview
The ifthenpay API allows you to easily generate payment references, receive notifications and query payments data. In order to make requests to our endpoints in test mode, please contact us and ask us for test keys for your desired payment methods.
To subscribe ifthenpay services, please fill in the following form.
Multibanco
Multibanco is a widely used payment system in Portugal that allows customers to pay for goods and services through ATMs, online banking, or mobile banking apps. It provides a secure and convenient way to make payments using a unique entity and reference number generated for each transaction. This system supports various payment types and is commonly integrated into e-commerce platforms to offer an offline payment option for customers.
To integrate with this API you will need an MB KEY assigned by ifthenpay to the merchant. If you do not have this MB KEY, please contact ifthenpay.
MB WAY
MB WAY is a popular digital payment solution in Portugal that allows users to make payments, send money, and withdraw cash using just their mobile phones. It is integrated with the Multibanco network and enables quick and secure transactions through a mobile app, without the need for physical cards. MB WAY is widely used for online shopping, in-store payments, bill splitting, and even ATM withdrawals, offering a versatile and user-friendly alternative for digital payments.
To integrate with this API you will need an MBWAY KEY assigned by ifthenpay to the merchant. If you do not have this MBWAY KEY, contact ifthenpay.
Payshop
Payshop is a convenient payment method in Portugal that allows customers to pay for goods and services at various physical locations such as kiosks, convenience stores, and other authorized agents. This cash-based payment solution is ideal for those who prefer not to use digital payment methods or credit cards. It enables users to make payments by presenting a unique Payshop reference code generated during the checkout process.
To integrate with this API you will need an PAYSHOP KEY assigned by ifthenpay to the merchant. If you do not have this PAYSHOP KEY, contact ifthenpay.
Credit Card
Credit Card payments are a widely used and secure payment method that allows customers to make purchases using their Visa, MasterCard, or other credit cards. It offers convenience and flexibility, supporting both online and in-store transactions. To integrate credit card payments through this API, merchants will need a CCARD KEY provided by Ifthenpay. This key is essential for securely processing credit card transactions within your platform.
To integrate with this API you will need an CCARD KEY assigned by ifthenpay to the merchant. If you do not have this CCARD KEY, contact ifthenpay.
Cofidis Pay
Cofidis Pay is a payment solution that offers customers the option to finance their purchases through installment payments, making it easier to manage larger transactions. This method provides flexibility and convenience, allowing buyers to spread the cost over time. For merchants, integrating Cofidis Pay can help increase conversion rates and average order values by offering an alternative payment method tailored for customers seeking financing options.
To integrate with this API you will need an COFIDIS KEY assigned by ifthenpay to the merchant. If you do not have this COFIDIS KEY, contact ifthenpay.
PAY BY LINK & PINPAY
PAY BY LINK is a simple and secure payment method where a merchant generates a unique payment link and shares it with a customer via email, SMS, or any messaging platform. The customer clicks the link, which directs them to a secure payment page where they can complete the transaction using their preferred payment method, such as a credit card, MB WAY, or others. This method is particularly useful for remote sales, customer support transactions, or any scenario where direct payment on a website is not feasible. It provides convenience for both customers and merchants, offering a seamless payment experience without the need for direct integration into an e-commerce platform.
PINPAY is an innovative service that simplifies and speeds up the payment process for invoices, services, purchases, and other transactions. The core of this service is the use of a unique PIN code that, once validated, guides the user to select their preferred payment method, providing all the necessary information to complete the payment securely. This solution is particularly useful for scenarios such as over-the-phone sales, on-site services, or other situations where a secure and efficient payment method is needed.
To integrate with this API you will need an GATEWAY KEY assigned by ifthenpay to the merchant. If you do not have this GATEWAY KEY, contact ifthenpay.
List of Payments
As an alternative or in addition to the callback (webhook), you can get a list of payments using this API.
Refunds
This API only allows refunds of MB WAY and Credit Cards payments.
Guides
Callback & Notifications
To receive notifications when a payment is confirmed, you must provide ifthenpay with your callback URL (webhook) for each payment method.
Multibanco Offline Algorithm
To integrate through this process you will need an entity code (5 numeric digits) and a sub-entity code (3 numeric digits) assigned by ifthenpay to the merchant. If you do not have this entity and sub-entity, contact ifthenpay.
E-commerce Integrations
You can find e-commerce integrations, including those for Shopify, Magento, PrestaShop, BigCommerce, Joomla, OpenCart, and more, in our GitHub repository. If you need assistance, please contact ifthenpay.
FAQ
Need Help? Check Our FAQ Section!If you have any questions or need assistance with using the Ifthenpay API, our FAQ section is a great place to start. It provides answers to common questions about integration, supported payment methods, testing, security, and more.
Visit our FAQ section to find quick and helpful answers to make your integration process smoother and more efficient!
Support
ifthenpay offers free technical support to all customers through the following channels:- E-mail: suporte@ifthenpay.com
- Phone: +351 227 660 871 | 808 222 777
- Helpdesk: submit a ticket
- Site: ifthenpay.com
This document was updated on September 20, 2024.