--- title: "Optimizing your integration: Key reminders" description: As we expand our partnership network and optimize our underlying architecture, we will be making use of Object ID strings and dynamic payment URLs. image: https://blog.mangopay.com/hubfs/Optimizing-your-integration.png --- [Skip to content](https://blog.mangopay.com/en/home/object-ids-payment-field-urls#main-content) [![Mangopay logo](https://blog.mangopay.com/hubfs/Logo-1.svg)](https://mangopay.com/) - [Visit Mangopay.com](https://mangopay.com) Open main navigation Close main navigation - [Visit Mangopay.com](https://mangopay.com) - [Contact Sales](https://mangopay.com/contact?utm_source=Mangopay%20blog&utm_medium=Blog&utm_campaign=Header) [Contact Sales](https://mangopay.com/contact?utm_source=Mangopay%20blog&utm_medium=Blog&utm_campaign=Header) ![companies](https://blog.mangopay.com/hubfs/companies.svg) Why am I here? Nethone is now part of Mangopay. Learn more about our award-winning [Fraud Prevention solution  ![arrow-right-thin-inline](https://blog.mangopay.com/hubfs/arrow-right-thin-inline.svg)](https://mangopay.com/products/fraud) # Optimizing your integration: Key reminders As we expand our partnership network and optimize our underlying architecture, it is important to ensure you are integrated into the Mangopay API correctly to continue to benefit from the improvements and optimization we make, with no integration effort from your side. ![Optimizing-your-integration-Mangopay-API](https://blog.mangopay.com/hubfs/Optimizing-your-integration-Mangopay-API.png) ![Optimizing-your-integration](https://blog.mangopay.com/hubfs/Optimizing-your-integration.png) [Dave Brown](https://blog.mangopay.com/en/home/author/dave-brown) [Learn](https://blog.mangopay.com/en/home/tag/learn) Dec 19, 2023 In this post, we highlight how you can make sure that you’re not hardcoding fields and that your integration has been set up according to our documentation. ## **Object IDs are Strings** In our documentation, IDs of objects are Strings and should be handled as such. Some engineers may have looked deeper at our object IDs over the years and noticed they contain numbers or, in some cases, UUIDs. There might be a desire to assume they can be treated as such in code such as converting to a *Number* or *UUID*. However, as Mangopay optimizes our underlying architecture, we require the freedom to change the internal format of these IDs. These changes allow us to use more advanced routing, sharding, and partitioning strategies while minimizing data lookup operations.   ## Payment Form URLs If your platform is using card payments, you are familiar with getting a URL from Mangopay to present to your users to collect card details or a URL to POST card details to. As we expand our partnership network, this URL will need to vary. It is important to ensure that your engineers are presenting the URL exactly as it comes from the API. Especially if you are using the [Card Registration API](https://mangopay.com/docs/endpoints/direct-card-payins#create-card-registration), *The CardRegistrationUR*L is dynamic and must not be hard coded. Everything from the host, path, and query parameters must be preserved as they are presented to you. ## Bank Account Details for Bankwires As we optimize our banking network, we will be making changes to bank account details for some of the currencies we support. These changes will begin to be rolled out in September 2024. If your platform is using bankwire pay-ins, and you dynamically retrieving bank account details such as **IBAN, BIC, and Account Number,** there is no action required from you. If you have hardcoded these fields, this may lead to issues as these bank account details will change. **Why dynamic retrieval matters:** - **Accuracy:** Ensures the most current and correct account information is used - **Reliability:** Minimizes the risk of payment failures due to outdated or incorrect information - **Compliance:** Keeps your integration aligned with regulatory requirements and banking standards When creating a direct bank wire pay-in, you should receive a response from our API that includes the necessary bank account details. Here is an example of what the response might look like: ![](https://blog.mangopay.com/hs-fs/hubfs/mangopay-integration-best-practices-png.png?width=601&height=525&name=mangopay-integration-best-practices-png.png) Please also keep in mind that there are cases when we add new fields as new payment data becomes available (for example new data on bankwire payins). As a general guidance, our API structure can change and new objects can be added. If you’ve integrated correctly these changes should not impact your existing integration. ---   For the latest information, please [visit our docs.](https://docs.mangopay.com/)   ## On the same topic [![](https://blog.mangopay.com/hubfs/zero-charge-card-validation.png)](https://blog.mangopay.com/en/home/mangopay-zero-charge-validation) [By Remay Villaester](https://blog.mangopay.com/en/home/author/remay-villaester) [News](https://blog.mangopay.com/en/home/tag/news), [Learn](https://blog.mangopay.com/en/home/tag/learn) Feb 1, 2024 ## [Introducing our enhanced “zero charge” card validation via 3DS authentication](https://blog.mangopay.com/en/home/mangopay-zero-charge-validation) [![](https://blog.mangopay.com/hubfs/7-30day-preauth.png)](https://blog.mangopay.com/en/home/7-or-30-day-preauthorization) [By Remay Villaester](https://blog.mangopay.com/en/home/author/remay-villaester) [News](https://blog.mangopay.com/en/home/tag/news), [Learn](https://blog.mangopay.com/en/home/tag/learn) Feb 1, 2024 ## [Enhance payment flexibility with our 7 or 30-day preauthorization](https://blog.mangopay.com/en/home/7-or-30-day-preauthorization) [![](https://blog.mangopay.com/hubfs/Mangopay%20500%20Small.png)](https://blog.mangopay.com/en/home/be-part-of-the-mangopay-500) [By Mangopay](https://blog.mangopay.com/en/home/author/mangopay) [News](https://blog.mangopay.com/en/home/tag/news) Aug 9, 2023 ## [Be part of the Mangopay 500!](https://blog.mangopay.com/en/home/be-part-of-the-mangopay-500) ![eu-flag](https://blog.mangopay.com/hs-fs/hubfs/eu-flag.png?width=24&height=24&name=eu-flag.png) EU Licensed & Regulated Financial Institution Products [E-wallet](https://mangopay.com/products/e-wallet) [Payments](https://mangopay.com/products/payments) [Identity](https://mangopay.com/products/identity) [Payout](https://mangopay.com/products/payout) [Fraud](https://nethone.com/) [FX](https://mangopay.com/products/fx) Solutions [C2C marketplaces](https://mangopay.com/solutions/c2c-marketplaces) [B2C marketplaces](https://mangopay.com/solutions/b2c-marketplaces) [B2B platforms](https://mangopay.com/solutions/b2b-platforms) [Retail marketplaces](https://mangopay.com/solutions/retail-marketplaces) [Rental marketplaces](https://mangopay.com/solutions/rental-marketplaces) Resources [Pricing](https://mangopay.com/pricing) [FAQ](https://support.mangopay.com/s/?language=en_US) [Blog](https://blog.mangopay.com/en/home) [Documentation](https://mangopay.com/docs) [Marketplace demo](https://demo-marketplace.mangopay.com/) Company [About us](https://mangopay.com/en) [Open positions](https://boards.eu.greenhouse.io/mangopay) [Working at Mangopay](https://mangopay.com/working-at-mangopay) [Press and media](https://mangopay.com/press-and-media) [Contacts us](https://mangopay.com/contact) [LinkedIn](https://www.linkedin.com/company/mangopay---leetchi-group) [YouTube](https://www.youtube.com/@mangopay-payment) [X](https://twitter.com/mangopay) © 2023 Mangopay. All rights reserved. [Legal notice](https://mangopay.com/legal-notice) [Privacy statement](https://mangopay.com/privacy-statement) [Privacy and cookie policy](https://mangopay.com/privacy-and-cookie-policy) [Terms & Conditions](https://mangopay.com/terms-and-conditions/payment-services) [Prohibited businesses](https://mangopay.com/prohibited-businesses) [EU Licensed and registered](https://finance.ec.europa.eu/consumer-finance-and-payments/payment-services_en) ![footer-logo](https://blog.mangopay.com/hubfs/footer-logo.svg) ```json { "@context" : "https://schema.org", "@type" : "BlogPosting", "author" : { "@type" : "Person", "name" : "Dave Brown", "url" : "https://blog.mangopay.com/en/home/author/dave-brown" }, "dateModified" : "2024-07-25T08:16:57.249Z", "datePublished" : "2023-12-19T04:39:41.000Z", "headline" : "Optimizing your integration: Key reminders", "image" : [ "https://blog.mangopay.com/hubfs/Optimizing-your-integration.png" ], "mainEntityOfPage" : { "@id" : "https://blog.mangopay.com/en/home/object-ids-payment-field-urls", "@type" : "WebPage" }, "publisher" : { "@type" : "Organization", "logo" : { "@type" : "ImageObject", "url" : "https://blog.mangopay.com/hubfs/Mangopay%20logo%20-%20Charcoal%20background@2x%20(1)-1.png" }, "name" : "MANGOPAY SA" } } ```