INFORMATION
WE WOULD LIKE TO INFORM YOU THAT THE NEW API DOCUMENTATION IS NOW AVAILABLE. THIS UPDATE OFFERS AN EVEN MORE SIMPLIFIED AND EFFICIENT WAY TO INTEGRATE OUR SERVICES.
CHECK THE NEW DOCUMENTATION
Why use the PINPAY service?
The PINPAY service is an innovative solution that simplifies and speeds up the payment process for invoices, services, purchases and other transactions.
The central element of this service is the use of a PIN code which, after validation, directs the user to choose the desired payment method, providing all the necessary information to complete the payment securely.
More information in https://pinpay.pt
API integration by POST:
URL EndPoint:
https://api.ifthenpay.com/gateway/pinpay/[GATEWAY_KEY]
* replace [GATEWAY_KEY] with the GatewayKey sent by Ifthenpay.
Request json format (Body)
{
"id": "1234",
"amount": "21.50",
"description": "Order 1234",
"lang": "en",
"expiredate": "",
"accounts": "MBWAY|XXX-000000;11686|000;MB|BEM-700700;...",
"btnCloseUrl": "http://url.com",
"btnCloseLabel": "Text Button",
"success_url": "https://company.com/sucess",
"error_url": "https://company.com/error",
"cancel_url":"https://company.com/cancel"
}
id: (mandatory) Maximum 15 numeric characters that identify your order/invoice. If you gateway for PayByLink use Offline Multibanco Reference method you can only use 4 numeric characters.
amount: (mandatory ) Decimal separator "." (ex: "21.50")
description: (optional) Short description of payment. Maximum 200 characters.
lang: (optional) Language presented to the customer at checkout (pt, en, es, fr). Default "pt".
expiredate: (optional) Expiry date of url in YYYYMMDD format (20211203)
accounts: (optional) Available methods for payment. (ex: ENTITY|SUBENTITY;MBWAY|MBWAY-KEY;PAYSHOP|PAYSHOP-KEY;CCARD|CCARD-KEY;MB|MB-KEY)
success_url: (optional) Redirect URL in case of successful payment.
error_url: (optional) Redirect URL in case of an error processing the payment.
cancel_url: (optional) Redirect URL if the user cancels payment processing.
Response Format
{
"PinCode": "1234567890",
"RedirectUrl": "https://gateway.ifthenpay.com/url/r54aiUE1dX"
}
CALLBACK (Webhook) :
You can define with ifthenpay a callback url endpoint and a antiphishing key. Evertime a payment is done, ifthenpay call that url and you can read the payment information on it:
Callback example :
Callback invoked example:
Support:
IFTHENPAY guarantees free technical assistance to all customers and the following channels can be used:
- Through the email suporte@ifthenpay.com
- By telephone: 808 222 777 | +351 227 660 871
- By opening a ticket in helpdesk