ifthenpay Payments MCP

Working · 1.7 s

com.ifthenpay/paymentsv1.0.2 Domain verified

Remote MCP for ifthenpay payments: Multibanco, MB WAY and Payshop.

Finance & Payments

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://ai.ifthenpay.com/mcp/payments/

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

creditcard_create_payment

Creates a credit/debit card payment session and returns a payment URL. The customer is redirected to a hosted checkout page to complete payment with their card.

amountnumber, required

Payment amount in EUR (e.g. 10.50).

order_idstring, required

Unique order identifier in your system (max 15 characters).

ccard_keystring, required

ifthenpay Credit Card key.

error_urlstring, required

URL to redirect the customer if the payment fails.

cancel_urlstring, required

URL to redirect the customer if they cancel the payment.

success_urlstring, required

URL to redirect the customer after a successful payment.

languagestring

Language for the checkout page (e.g. "pt", "en"). Defaults to "pt".

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (8)

creditcard_create_payment

Creates a credit/debit card payment session and returns a payment URL. The customer is redirected to a hosted checkout page to complete payment with their card.

Argument	Type	Description
amount*	number	Payment amount in EUR (e.g. 10.50).
language	string	Language for the checkout page (e.g. "pt", "en"). Defaults to "pt".
order_id*	string	Unique order identifier in your system (max 15 characters).
ccard_key*	string	ifthenpay Credit Card key.
error_url*	string	URL to redirect the customer if the payment fails.
cancel_url*	string	URL to redirect the customer if they cancel the payment.
success_url*	string	URL to redirect the customer after a successful payment.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ccard_key",
    "order_id",
    "amount",
    "success_url",
    "error_url",
    "cancel_url"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Payment amount in EUR (e.g. 10.50)."
    },
    "language": {
      "type": "string",
      "description": "Language for the checkout page (e.g. \"pt\", \"en\"). Defaults to \"pt\"."
    },
    "order_id": {
      "type": "string",
      "description": "Unique order identifier in your system (max 15 characters)."
    },
    "ccard_key": {
      "type": "string",
      "description": "ifthenpay Credit Card key."
    },
    "error_url": {
      "type": "string",
      "description": "URL to redirect the customer if the payment fails."
    },
    "cancel_url": {
      "type": "string",
      "description": "URL to redirect the customer if they cancel the payment."
    },
    "success_url": {
      "type": "string",
      "description": "URL to redirect the customer after a successful payment."
    }
  }
}

mbway_check_status

Checks the status of a previously requested MB WAY payment. Returns pending, paid, declined, timeout, or cancelled.

Argument	Type	Description
mbway_key*	string	ifthenpay MB WAY key.
request_id*	string	Request ID returned by mbway_request_payment.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mbway_key",
    "request_id"
  ],
  "properties": {
    "mbway_key": {
      "type": "string",
      "description": "ifthenpay MB WAY key."
    },
    "request_id": {
      "type": "string",
      "description": "Request ID returned by mbway_request_payment."
    }
  }
}

mbway_request_payment

Sends an MB WAY payment request to the customer's mobile phone. The customer approves the payment in the MB WAY app. Use mbway_check_status to check the result.

Argument	Type	Description
phone*	string	Customer mobile number in format "351#912345678" (country code # number).
amount*	number	Payment amount in EUR (e.g. 10.50).
order_id*	string	Unique order identifier in your system (max 15 characters).
mbway_key*	string	ifthenpay MB WAY key.
description	string	Short payment description shown in the MB WAY app.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mbway_key",
    "order_id",
    "amount",
    "phone"
  ],
  "properties": {
    "phone": {
      "type": "string",
      "description": "Customer mobile number in format \"351#912345678\" (country code # number)."
    },
    "amount": {
      "type": "number",
      "description": "Payment amount in EUR (e.g. 10.50)."
    },
    "order_id": {
      "type": "string",
      "description": "Unique order identifier in your system (max 15 characters)."
    },
    "mbway_key": {
      "type": "string",
      "description": "ifthenpay MB WAY key."
    },
    "description": {
      "type": "string",
      "description": "Short payment description shown in the MB WAY app."
    }
  }
}

multibanco_create_reference

Creates a Multibanco payment reference that the customer can use to pay at any ATM or via online banking in Portugal.

Argument	Type	Description
amount*	number	Payment amount in EUR (e.g. 10.50).
mb_key*	string	ifthenpay Multibanco key.
order_id*	string	Unique order identifier in your system.
expiry_days	integer	Number of days until the reference expires. Defaults to no expiry if omitted.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "mb_key",
    "order_id",
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Payment amount in EUR (e.g. 10.50)."
    },
    "mb_key": {
      "type": "string",
      "description": "ifthenpay Multibanco key."
    },
    "order_id": {
      "type": "string",
      "description": "Unique order identifier in your system."
    },
    "expiry_days": {
      "type": "integer",
      "description": "Number of days until the reference expires. Defaults to no expiry if omitted."
    }
  }
}

payments_list

Lists completed payments using the ifthenpay Backoffice Key. Filter by payment method, date range, order ID, reference or request ID. Returns up to 1000 most recent payments if no filters are applied.

Argument	Type	Description
amount	string	Filter by exact payment amount.
bo_key*	string	ifthenpay Backoffice Key (provided when signing the contract).
entity	string	Payment method entity filter. Use: MB, MBWAY, PAYSHOP, CCARD, GOOGLE, APPLE, PIX, or a 5-digit Multibanco entity number. Leave blank for all methods.
date_end	string	End date/time in format dd-MM-yyyy HH:mm:ss (e.g. 31-01-2024 23:59:59).
order_id	string	Filter by order identifier.
reference	string	Filter by payment reference (Multibanco/Payshop reference or orderId for other methods).
date_start	string	Start date/time in format dd-MM-yyyy HH:mm:ss (e.g. 01-01-2024 00:00:00).
request_id	string	Filter by the unique request token returned at payment creation.
sub_entity

payshop_create_reference

Creates a Payshop payment reference that the customer can use to pay at any Payshop agent or CTT (postal service) in Portugal.

Argument	Type	Description
amount*	number	Payment amount in EUR (e.g. 10.50).
order_id*	string	Unique order identifier in your system (max 25 characters).
expiry_date	string	Expiry date in YYYYMMDD format (e.g. 20301231). Leave blank for no expiry.
payshop_key*	string	ifthenpay Payshop key.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "payshop_key",
    "order_id",
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Payment amount in EUR (e.g. 10.50)."
    },
    "order_id": {
      "type": "string",
      "description": "Unique order identifier in your system (max 25 characters)."
    },
    "expiry_date": {
      "type": "string",
      "description": "Expiry date in YYYYMMDD format (e.g. 20301231). Leave blank for no expiry."
    },
    "payshop_key": {
      "type": "string",
      "description": "ifthenpay Payshop key."
    }
  }
}

pinpay_create_payment

Creates a Pay by Link / PINPAY payment. Returns a shareable payment URL and a PIN code. The hosted checkout supports multiple payment methods including Credit Card, Google Pay, and Apple Pay.

Argument	Type	Description
otp	string	One-time payment: "true" makes the link expire after a single payment.
lang	string	Language for the payment page: pt, en, es, fr. Defaults to pt.
amount*	number	Payment amount in EUR (e.g. 10.50).
accounts	string	Payment methods to show in the gateway, separated by semicolons. Format: METHOD\|KEY (e.g. "MBWAY\|MBWAY-KEY;MB\|MB-KEY;PAYSHOP\|PAYSHOP-KEY;CCARD\|CCARD-KEY"). Leave blank to use gateway defaults.
order_id*	string	Unique order identifier in your system (max 15 characters).
error_url	string	URL to redirect the customer if the payment fails.
cancel_url	string	URL to redirect the customer if they cancel.
description	string	Short description shown on the payment page (max 200 characters).

pix_create_payment

Creates a PIX payment for Brazilian customers. Returns a payment URL and a QR code value. Customer must have a CPF number (Brazilian tax ID).

Argument	Type	Description
amount*	number	Payment amount in BRL (e.g. 50.00).
pix_key*	string	ifthenpay PIX key.
order_id*	string	Unique order identifier in your system (max 25 characters).
description	string	Short description or reference for the payment (max 200 characters).
customer_cpf*	string	Customer CPF number (Brazilian tax ID), digits only (e.g. 74026594025).
redirect_url*	string	URL to redirect the customer after payment. Check payment status via the status API after redirect.
customer_city	string	Customer city.
customer_name*	string	Full name of the customer (max 150 characters).

{ "type": "object", "required": [ "gateway_key", "order_id", "amount" ], "properties": { "otp": { "enum": [ "true", "false" ], "type": "string", "description": "One-time payment: \"true\" makes the link expire after a single payment." }, "lang": { "type": "string", "description": "Language for the payment page: pt, en, es, fr. Defaults to pt." }, "amount": { "type": "number", "description": "Payment amount in EUR (e.g. 10.50)." }, "accounts": { "type": "string", "description": "Payment methods to show in the gateway, separated by semicolons. Format: METHOD|KEY (e.g. \"MBWAY|MBWAY-KEY;MB|MB-KEY;PAYSHOP|PAYSHOP-KEY;CCARD|CCARD-KEY\"). Leave blank to use gateway defaults." }, "order_id": { "type": "string", "description": "Unique order identifier in your system (max 15 characters)." }, "error_url": { "type": "string", "description": "URL to redirect the customer if the payment fails." }, "cancel_url": { "type": "string", "description": "URL to redirect the customer if they cancel." }, "description": { "type": "string", "description": "Short description shown on the payment page (max 200 characters)." }, "expiry_date": { "type": "string", "description": "Link expiry date in YYYYMMDD format (e.g. 20301231). Leave blank for no expiry." }, "gateway_key": { "type": "string", "description": "ifthenpay Gateway key for Pay by Link / PINPAY." }, "success_url": { "type": "string", "description": "URL to redirect the customer after a successful payment." }, "btn_close_url": { "type": "string", "description": "URL for the close/back button on the payment page." }, "btn_close_label": { "type": "string", "description": "Label text for the close/back button." }, "selected_method": { "enum": [ "1", "2", "3", "4", "7", "8" ], "type": "string", "description": "Pre-select a payment method: 1=Multibanco, 2=MB WAY, 3=Payshop, 4=Credit Card, 8=Pix." } } }