ifthenpay Payments MCP

{'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.'}}}

{'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.'}}}

{'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.'}}}

{'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.'}}}

{'type': 'object', 'required': ['bo_key'], 'properties': {'amount': {'type': 'string', 'description': 'Filter by exact payment amount.'}, 'bo_key': {'type': 'string', 'description': 'ifthenpay Backoffice Key (provided when signing the contract).'}, 'entity': {'type': 'string', 'description': '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': {'type': 'string', 'description': 'End date/time in format dd-MM-yyyy HH:mm:ss (e.g. 31-01-2024 23:59:59).'}, 'order_id': {'type': 'string', 'description': 'Filter by order identifier.'}, 'reference': {'type': 'string', 'description': 'Filter by payment reference (Multibanco/Payshop reference or orderId for other methods).'}, 'date_start': {'type': 'string', 'description': 'Start date/time in format dd-MM-yyyy HH:mm:ss (e.g. 01-01-2024 00:00:00).'}, 'request_id': {'type': 'string', 'description': 'Filter by the unique request token returned at payment creation.'}, 'sub_entity': {'type': 'string', 'description': 'Payment method key or sub-entity (e.g. MB KEY, MBWAY KEY, PAYSHOP KEY). Leave blank to match all.'}}}

{'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.'}}}

{'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.'}}}

{'type': 'object', 'required': ['pix_key', 'order_id', 'amount', 'redirect_url', 'customer_name', 'customer_cpf', 'customer_email', 'customer_phone'], 'properties': {'amount': {'type': 'number', 'description': 'Payment amount in BRL (e.g. 50.00).'}, 'pix_key': {'type': 'string', 'description': 'ifthenpay PIX key.'}, 'order_id': {'type': 'string', 'description': 'Unique order identifier in your system (max 25 characters).'}, 'description': {'type': 'string', 'description': 'Short description or reference for the payment (max 200 characters).'}, 'customer_cpf': {'type': 'string', 'description': 'Customer CPF number (Brazilian tax ID), digits only (e.g. 74026594025).'}, 'redirect_url': {'type': 'string', 'description': 'URL to redirect the customer after payment. Check payment status via the status API after redirect.'}, 'customer_city': {'type': 'string', 'description': 'Customer city.'}, 'customer_name': {'type': 'string', 'description': 'Full name of the customer (max 150 characters).'}, 'customer_email': {'type': 'string', 'description': 'Customer email address.'}, 'customer_phone': {'type': 'string', 'description': 'Customer phone number including country code (e.g. +5585912345678).'}, 'customer_state': {'type': 'string', 'description': 'Customer state (e.g. CE, SP).'}, 'customer_address': {'type': 'string', 'description': 'Customer street address.'}, 'customer_zip_code': {'type': 'string', 'description': 'Customer postal/ZIP code.'}}}