PHP SDK - 3.52.0 | Mangopay docs

Mar 30, 2026

Idempotency mapping

Breaking change

Idempotency resource mapping improvements

The GetObjectForIdempotencyUrl method has been updated with missing mappings and corrected entries. This may affect responses retrieved via Responses->Get($idempotencyKey):

Previously unmapped POST endpoints will now return a typed entity instead of a raw stdClass. The following endpoints are now mapped:
- Pay-ins: payins_directdebitdirect-direct_create, payins_paypal-web_create, payins_paypal-web_create_v2, payins_applepay-direct_create, payins_googlepay-direct_create, payins_googlepay-direct_create_v2, payins_mbway-web_create, payins_multibanco-web_create, payins_satispay-web_create, payins_blik-web_create, payins_klarna-web_create, payins_ideal-web_create, payins_giropay-web_create, payins_bancontact-web_create, payins_bizum-web_create, payins_swish-web_create, payins_twint-web_create, payins_paybybank-web_create, payins_create_card_pre_authorized_deposit, payins_deposit_preauthorized_prior_to_complement, payins_deposit_preauthorized_complement, client_create_bank_wire_direct_payin, acquiring_payins_card-direct_create, acquiring_payins_ideal-web_create, acquiring_payins_applepay-direct_create, acquiring_payins_googlepay-direct_create, acquiring_payins_paypal-web_create
- Recurring pay-ins: payins_recurring_paypal, payins_recurring_card_direct, payins_recurring_registration
- Pay-in intents: payins_intent_cancel, payins_intent_create_refund, payins_intent_reverse_refund, payins_intent_create_dispute
- Pay-outs: client_create_payout, payouts_check_eligibility
- Refunds: acquiring_payins_createrefunds
- Card validation: card_validate, acquiring_card_validate
- Payment method metadata: payment_method-metadata
- Document consult: disputes_document_create_consult, kyc_documents_create_consult
- Bank accounts: client_create_bank_account_iban, banking_aliases_iban_create
- Deposits: deposits_create
- UBO: ubo_declaration_create, ubo_create
- Conversions: create_instant_conversion, create_client_wallets_instant_conversion, create_quoted_conversion, create_client_wallets_quoted_conversion, create_conversion_quote
- Settlements: settlement_cancel
- Users: users_enroll_sca, users_manage_consent, validate_the_format_of_user_data
- Raw response (no entity cast): payins_paypal_data_collection_create, acquiring_payins_paypal_data_collection_create, recipients_validate
The following methods were missing the $idempotencyKey parameter and have had it added as an optional (defaulting to null, non-breaking) last argument:
- ApiPayIns::CreateDepositPreauthorizedPayInWithoutComplement
- ApiPayIns::CreateDepositPreauthorizedPayInPriorToComplement
- ApiPayIns::CreateDepositPreauthorizedPayInComplement
- ApiConversions::CreateInstantConversion
- ApiConversions::CreateClientWalletsInstantConversion
- ApiConversions::CreateQuotedConversion
- ApiConversions::CreateClientWalletsQuotedConversion
- ApiConversions::CreateConversionQuote
- ApiDeposits::Create
- ApiBankingAliases::Create
- ApiUsers::ValidateTheFormatOfUserData

Payconiq removal

Breaking change
###

Payconiq PayIn removed following discontinuation

Payconiq was discontinued on 4th December 2025. The following have been removed:

ApiPayIns::CreatePayconiq() method
PayInPaymentDetailsPayconiq class
PayInPaymentType::Payconiq constant
URL keys payins_payconiq-web_create and payins_payconiqv2-web_create from ApiBase

Klarna discount parameter

Added
###

Klarna discount property on LineItems

Added Discount support to LineItem objects used in Klarna pay-ins.