> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# PHP SDK - 3.52.0

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.

---