Skip to content

Commit 7949282

Browse files
Update transition-to-one-platform.md
1 parent e126065 commit 7949282

File tree

1 file changed

+36
-47
lines changed

1 file changed

+36
-47
lines changed

docs/app-payments/transition-to-one-platform.md

+36-47
Original file line numberDiff line numberDiff line change
@@ -20,18 +20,48 @@ There is no need to reintegrate into the new solution yet as the existing App Pa
2020
- **2024** Plan and integrate new [ePayments API](https://developer.vippsmobilepay.com/docs/APIs/epayment-api/)
2121
- **2025Q1** Be ready with your API integration to the App Payments API. The facade will be switched off.
2222

23-
### The test environment for the new platform
23+
## Test options
24+
The first version of the new test environment is ready for the App Payments facade. All features except Refund is available.
2425

25-
The test environment is called Merchant Test (MT) and is now open for test. MT currently only allows Norwegian phone numbers, currency and merchants, but you can test the API and payment flow. Please see the details of [limitations of the test environment](https://developer.vippsmobilepay.com/docs/test-environment/)
26+
### Test credentials
27+
**Test merchant**: Find a guide to create test merchant [here](https://developer.vippsmobilepay.com/docs/developer-resources/portal/#how-to-create-a-test-sales-unit). The test credentials consist of a client id, client secret and subscriptions key.
28+
**Test user**: Find a guide to create test users [here](https://developer.vippsmobilepay.com/docs/test-environment/#test-users)
29+
*For partners*: Please contact [email protected] to request a DK or FI test merchant and user.
2630

27-
In order to request access to the test environment, please use the following links:
31+
Please note: If you want to reuse your App Payments test data you will need to recreate your test data. Please note that all test data, including payments, refunds, and so on, created on the old platform will not be migrated from the sandbox to the merchant test environment.
2832

29-
- [Partners](https://www.vippsmobilepay.com/partner/become-a-partner)
30-
- [Merchants](https://vippsmobilepay.com/merchant-test-account-sign-up)
33+
**Authentication**
34+
You will have to integrate with the new and simplified Access Token API designed for the merchant test environment. The old MobilePay-issued API key for the sandbox will cease to function. [Access token API guide](https://developer.vippsmobilepay.com/docs/APIs/access-token-api/) Prod API keys will continue to work.
35+
36+
### UserSimulation endpoint
37+
The request to the userSimulation endpoint will be simplified.
38+
```bash title="Old MobilePay request"
39+
curl https://api.sandbox.mobilepay.dk/v1/integration-test/payments/{paymentid}/reserve \
40+
-X POST \
41+
-H 'Authorization: Bearer {API_KEY or JWT}' \
42+
-H 'Content-Type: application/json' \
43+
-d '{
44+
"paymentSourceId": {UUID},
45+
"userId": {UUID}
46+
}'
47+
```
3148

49+
For the new setup you will not need to supply a userId or paymentSourceId but instead a phoneNumber. When registering for test access on the new platform you will receive a new test phoneNumber
3250

33-
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.
51+
```bash title="New Vipps MobilePay request"
52+
curl https://api.sandbox.mobilepay.dk/v1/integration-test/payments/{PAYMENT_ID}/reserve \
53+
-X POST \
54+
-H 'Authorization: Bearer {API_KEY or JWT}' \
55+
-H 'Content-Type: application/json' \
56+
-H 'Ocp-Apim-Subscription-Key: {subscriptions key}' \
57+
--header 'Content-Type: application/json' \
58+
--header 'Merchant-Serial-Number: {MSN}'
59+
-d '{
60+
"phoneNumber": {string}
61+
}'
62+
```
3463

64+
`phoneNumber` must be international phone number including contry code. For example: `4512345678`
3565

3666
## App Payments Facade
3767
To ease the switch to a new platform we will supply a facade for the existing MobilePay App Payments API that will be available during and after the launch of the new platform. There is no need to reintegrate into the new solution now. Your existing App Payments integration will continue to work and 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 moment we transition to One Platform. To ensure a smooth experience, we recommend reviewing the upcoming changes outlined below and consider updating your integration accordingly. Please take a moment to familiarize yourself with the upcoming changes and how they may impact your integration.
@@ -128,44 +158,3 @@ From the launch of our new platform you will be able to use the new [ePayments A
128158
The payment point was deprecated in 2023 since it won't continue to function as is on the facade. It is still possible to use it, but it will be limited to only returning payments with status 'Reserved' going forward.
129159
Find the API spec for the endpoint here: https://developer.mobilepay.dk/api/app-payments#tag/Payments/operation/get-payments-list
130160

131-
### Test options
132-
The first version of the new test environment is ready for the App Payments facade. All features except Refund is available.
133-
134-
#### Test credentials
135-
**Test merchant**: Find a guide to create test merchant [here](https://developer.vippsmobilepay.com/docs/developer-resources/portal/#how-to-create-a-test-sales-unit). The test credentials consist of a client id, client secret and subscriptions key.
136-
**Test user**: Find a guide to create test users [here](https://developer.vippsmobilepay.com/docs/test-environment/#test-users)
137-
*For partners*: Please contact [email protected] to request a DK or FI test merchant and user.
138-
139-
Please note: If you want to reuse your App Payments test data you will need to recreate your test data. Please note that all test data, including payments, refunds, and so on, created on the old platform will not be migrated from the sandbox to the merchant test environment.
140-
141-
**Authentication** You will have to integrate with the new and simplified Access Token API designed for the merchant test environment. The old MobilePay-issued API key for the sandbox will cease to function. [Access token API guide](https://developer.vippsmobilepay.com/docs/APIs/access-token-api/) Prod API keys will continue to work.
142-
143-
#### UserSimulation endpoint
144-
The request to the userSimulation endpoint will be simplified.
145-
```bash title="Old MobilePay request"
146-
curl https://api.sandbox.mobilepay.dk/v1/integration-test/payments/{paymentid}/reserve \
147-
-X POST \
148-
-H 'Authorization: Bearer {API_KEY or JWT}' \
149-
-H 'Content-Type: application/json' \
150-
-d '{
151-
"paymentSourceId": {UUID},
152-
"userId": {UUID}
153-
}'
154-
```
155-
156-
For the new setup you will not need to supply a userId or paymentSourceId but instead a phoneNumber. When registering for test access on the new platform you will receive a new test phoneNumber
157-
158-
```bash title="New Vipps MobilePay request"
159-
curl https://api.sandbox.mobilepay.dk/v1/integration-test/payments/{PAYMENT_ID}/reserve \
160-
-X POST \
161-
-H 'Authorization: Bearer {API_KEY or JWT}' \
162-
-H 'Content-Type: application/json' \
163-
-H 'Ocp-Apim-Subscription-Key: {subscriptions key}' \
164-
--header 'Content-Type: application/json' \
165-
--header 'Merchant-Serial-Number: {MSN}'
166-
-d '{
167-
"phoneNumber": {string}
168-
}'
169-
```
170-
171-
`phoneNumber` must be international phone number including contry code. For example: `4512345678`

0 commit comments

Comments
 (0)