You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/subscriptions/transition-to-one-platform.md
+24-73
Original file line number
Diff line number
Diff line change
@@ -5,12 +5,19 @@ import Launch from '/docs/shared-blocks/_launch.mdx';
5
5
6
6
# 💙🧡 Preparation for the facade period
7
7
8
-
Your existing Subscriptions APIs will continue to work until the end of 2024 through facade we build.
9
-
While our primary goal is to provide an effortless transition, we want to inform you that some functionality will be changing or closed starting from the Nordic Wallet Launch 🚀. Thank you for being a part of our journey toward creating the best and most user-friendly payment wallet in the Nordics. :orange_heart::blue_heart:
8
+
Thank you for being a part of our journey toward creating the best and most user-friendly payment wallet in the Nordics. :orange_heart::blue_heart:
9
+
10
+
### When can I integrate to the Recurring API?**
11
+
If you already want to reintegrate you can start now!
12
+
13
+
It is still the same team as before that is here to assist you with technical questions. Just send an email to [email protected], and we'll be happy to help! 😊
14
+
15
+
-[NEW Recurring API Reference](https://developer.vippsmobilepay.com/api/recurring/): Explore the documentation for the New Recurring API.
16
+
17
+
-[NEW Recurring API Documentation](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/): Find detailed information on the New Recurring API.
18
+
19
+
-[NEW Recurring Changelogs](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/CHANGELOG/): All notable changes to the Recurring API.
10
20
11
-
:::danger Important info
12
-
To make the transition as smooth as possible, we will migrate all merchants and automatically switch you to the new facade once it is live.
13
-
:::
14
21
15
22
**Timeline for existing subscriptions merchants and partners**
16
23
@@ -101,9 +108,9 @@ This one is a bit more technical. ⚙️ Currently, we are saving every payment
101
108
### 3.1 One-off payments types
102
109
103
110
One-off payments in Subscriptions are used in 3 different ways:
104
-
*[Flow 1](https://developer.mobilepay.dk/docs/subscriptions/one-off-payments#flow-1--one-off-payment-with-a-new-agreement): Create a new Agreement with an initial One-Off Payment. ✅ Will continue.
105
-
*[Flow 2](https://developer.mobilepay.dk/docs/subscriptions/one-off-payments#flow-2---one-off-payment-on-an-existing-agreement): Customer can initiate and request arbitrary One-Off Payment payments on their existing Agreement. ❌ Will be terminated.
106
-
*[Flow 3](https://developer.mobilepay.dk/docs/subscriptions/one-off-payments#flow-3---one-off-with-auto-reserve): Merchants can send One-Off payment, which MobilePay will attempt to automatically reserve, without user’s confirmation. ✅ Will continue.
111
+
* Create a new Agreement with an initial One-Off Payment. ✅ Will continue.
112
+
* Customer can initiate and request arbitrary One-Off Payment payments on their existing Agreement. ❌ Will be terminated.
113
+
* Merchants can send One-Off payment, which MobilePay will attempt to automatically reserve, without user’s confirmation. ✅ Will continue.
107
114
108
115
We reevaluated all our product packages, and usage of this feature and we decided, that from Nordic Wallet Launch, flow 2 will be moved from Subscriptions (Recurring) product to another Vipps MobilePay product - ePayment! 🍀 We are planning to keep flows 1 and 3 in the Subscriptions product and also in the Recurring product. Basically, all payments which are merchant initiated (MIT) and do not require Strong Customer Authentication (SCA) stay in Subscriptions and also Recurring. All payments where SCA is needed will be in ePayment product.
109
116
@@ -470,11 +477,8 @@ The endpoints have not changed. Please find them in the [API specification](http
470
477
471
478
## **FAQ**
472
479
473
-
### **1. Do I need to reintegrate now to the new solution, APIs?**
474
-
475
-
No, you don't need to reintegrate to the new solution right now. We are building Facade which will forward all your integration messages to the new solution and return needed responses. The only thing we ask you is to review the upcoming changes outlined above and update your integration accordingly.
476
480
477
-
### **2. How will the migration of data work?**
481
+
### **1. How will the migration of data work?**
478
482
479
483
Vipps MobilePay will make sure that all needed data is migrated from Subscriptions to Recurring:
480
484
- All active merchants and their payment points will be migrated to the new system. The primary identifiers are `provider_id`, `agreement_id`, `payment_id`, and `refund_id`. These remain unchanged; there is no changes there.
@@ -489,7 +493,6 @@ Vipps MobilePay will make sure that all needed data is migrated from Subscriptio
489
493
490
494
- We will migrate 3 years of historical production data (agreements, payment requests, refunds) to the new environment.
491
495
492
-
Sandbox data will not be migrated due to different merchant and payment point setups.
493
496
494
497
If you have a need to have a list of old and new ID's, we have an endpoint for obtaining agreements that offers both `ExternalId` and `AgreementUuid`.
495
498
Please refer to the [NEW Recurring API endpoint description](https://developer.vippsmobilepay.com/api/recurring/) - You can utilize `Agreement-v3-endpoints ListAgreementsV3` endpoint for mapping.
@@ -498,7 +501,6 @@ Please refer to the [NEW Recurring API endpoint description](https://developer.v
498
501
499
502
-Facade merchants: There will be not changes to the identifiers. The facade api will return the exact same identifiers.
500
503
501
-
502
504
Below you can find information for when merchants will re-integrate to the [NEW Recurring API Reference](https://developer.vippsmobilepay.com/api/recurring/)
503
505
504
506
@@ -573,22 +575,7 @@ POST Charges endpoint :
573
575
- No externalId and no status_callback_url are needed.
574
576
- Amount has to be equal or superior to 100.
575
577
576
-
### **3. When can I integrate to the Recurring API?**
577
-
578
-
If you already want to reintegrate you can start now!
579
-
580
-
It is still the same team as before that is here to assist you with technical questions. Just send an email to [email protected], and we'll be happy to help! 😊
581
-
582
-
-[NEW Recurring API Reference](https://developer.vippsmobilepay.com/api/recurring/): Explore the documentation for the New Recurring API.
583
-
584
-
-[NEW Recurring API Documentation](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/): Find detailed information on the New Recurring API.
585
-
586
-
-[NEW Recurring Changelogs](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/CHANGELOG/): All notable changes to the Recurring API.
@@ -599,7 +586,7 @@ Another method is [polling](https://developer.vippsmobilepay.com/docs/knowledge-
599
586
Callbacks will work on the facade API.
600
587
601
588
602
-
### **5. Will I be able to test the new Recurring API?**
589
+
### **3. Will I be able to test the new Recurring API?**
603
590
You will be able to test the new Recurring API through the merchant test environment on the new platform. If you want to test the Mobilepay Subscriptions facade instead please [read here](https://developer.mobilepay.dk/docs/subscriptions/transition-to-one-platform#10-test).
604
591
605
592
Please note:
@@ -615,59 +602,23 @@ In order to request access to the test environment, please use the following lin
615
602
616
603
We will send you an e-mail with the information you need to get started. This is also needed even though you are an existing MobilePay integrator or merchant, since we need your information registered on our new joint platform.
617
604
618
-
### **6. How will I find data about my payments?**
605
+
### **4. How will I find data about my payments?**
619
606
620
607
We will migrate 3 years of historical data (agreements, payment requests, refunds). You will be able to access that data though:
621
608
1. API GET calls. For new and historical data.
622
609
3. Though [Merchant Portal](https://portal.vipps.no/register). Just for new transactions done after Nordic Wallet Launch.
623
610
4. Integrate it into the [Report API](https://developer.vippsmobilepay.com/docs/APIs/report-api/). Read more [here](https://developer.vippsmobilepay.com/docs/mp-migration-guide/reporting/) about transition period.
624
611
625
-
### **7. I am using Transaction Reporting API, what should I do?**
626
-
627
-
Sadly, we are not builing any facade for Transaction reporting API. We are asking you to reintegrate to alternative solution [Report API](https://developer.vippsmobilepay.com/docs/APIs/report-api/). Read more [here](https://developer.vippsmobilepay.com/docs/mp-migration-guide/reporting/) about transition period.
628
-
### **8. Will users get a new app?**
612
+
### **5. I am using Transaction Reporting API, what should I do?**
629
613
630
-
Yes, all app users will need to download the new app versions; this will be a mandatory upgrade on Nordic Wallet Launch day. We will ensure that users do not need to create new accounts; their profiles will be seamlessly migrated to the new platform. However, since users need to download the new app version, there is an increased risk of expired payments around 12th of march.
614
+
We are asking you to reintegrate to alternative solution [Report API](https://developer.vippsmobilepay.com/docs/APIs/report-api/). Read more [here](https://developer.vippsmobilepay.com/docs/mp-migration-guide/reporting/) about transition period.
631
615
632
-
### **9. What cool features are there ahead?**
616
+
### **6. What cool features are there ahead?**
633
617
634
-
There are several exciting features on the horizon. For instance, there's profile sharing, allowing merchants to request users to share various information from the app, thereby streamlining the signup process. Additionally, we have upcoming campaigns, improved refund processes, enhanced capture capabilities, increased limits, expansion into three new markets, and various other flexibility improvements.
635
-
618
+
For instance, there's profile sharing, allowing merchants to request users to share various information from the app, thereby streamlining the signup process. Additionally, we have upcoming campaigns, improved refund processes, enhanced capture capabilities, increased limits, expansion into three new markets, and various other flexibility improvements.
636
619
637
620
638
621
## **Developer Support**
639
622
640
623
We're Here to Help!
641
-
If you have any questions, our Developer support team ([email protected]) is available to provide guidance and support. We're like your trusty sidekick, always by your side, committed to making your payment experience as smooth as a well-oiled machine.
642
-
643
-
644
-
645
-
## **Changelog**
646
-
647
-
2024-05-03 Information about test.
648
-
649
-
2024-03-01 Removed 8.3. Gross settlement type stays in use after NWL.
650
-
651
-
2024-02-29 Removed 8.2. Settlement time does not change for Denmark and Finland.
652
-
653
-
2024-02-19 Updated 1.1 and 3.2. Default expiration time changed to 10 min.
654
-
655
-
2024-01-08 Added new section 1.4 Agreement cancelation by merchant. Recommendations how to test the facade added.
656
-
657
-
2023-11-28 FAQ #6 and #7 updated regarding Report API
658
-
659
-
2023-11-22 FAQ #2 updated
660
-
661
-
2023-09-05 Added section 8. Callbacks
662
-
663
-
2023-09-07 Added callback sending DNS address list
664
-
665
-
2023-09-20 FAQ "How will I find data about my payments?" updated; FAQ "I am using Transaction Reportin API, what should I do?" added
666
-
667
-
2023-10-05 New section "Settlements" with 3 new items added
668
-
669
-
2023-10-09 Changed callback status codes from "6000..." to "7000..."
670
-
671
-
2023-10-11 Section 9 renamed to Other and new topic added 9.3 Error messages.
672
-
673
-
2023-10-11 Clarification, that OAuth2 token retrieval requests will be sent from new DNS address
624
+
If you have any questions, our Developer support team ([email protected]) is available to provide guidance and support.
0 commit comments