Skip to content

Commit ce6d8d6

Browse files
Update notification-service.md
1 parent 857b547 commit ce6d8d6

File tree

1 file changed

+4
-29
lines changed

1 file changed

+4
-29
lines changed

docs/pos/notification-service.md

+4-29
Original file line numberDiff line numberDiff line change
@@ -2,34 +2,9 @@
22
sidebar_position: 6
33
---
44

5-
# Notification Service
5+
:::caution
66

7-
Clients that are unable to detect whether a customer has checked in by [user activation](/docs/pos/detecting-mobilepay#user-activation) can use the notification service. To be able to use the notification service, the integrator needs to implement an endpoint that MobilePay will call, when a client should query the active check-in on a PoS.
7+
Please notice that as part of the merger between MobilePay and Norwegian Vipps, we will consolidate products on one joint platform.
8+
This product is now closed. Please visit our new developer documentation to see the new APIs we offer https://developer.vippsmobilepay.com/
89

9-
When the endpoint is implemented the URL has to be communicated to MobilePay in order to validate and whitelist it in the firewalls. This is done by sending an email to [[email protected]](mailto:[email protected]). When the URL is whitelisted the integrator will receive a reference to that URL called a ``CallbackAlias``. The client will use this alias when [creating a PoS](/docs/pos/pos-management#pos-creation) to indicate which notification endpoint to call.
10-
11-
## Notification endpoint
12-
13-
The requirements for a notification endpoint are as follows:
14-
15-
* It must be an HTTPS POST endpoint.
16-
* It must accept a JSON body that has the following format:
17-
18-
```javascript
19-
{
20-
"MerchantId" : "622d3369-f940-4921-93eb-c8fca0c081b4",
21-
"MerchantBrandId" : "MPPOS12345",
22-
"MerchantLocationId" : "12345",
23-
"MerchantPosId" : "MobilePay Merchant Pos Id"
24-
"PosId" : "7e6acbde-345e-4641-b2f4-d8df0f3a5147"
25-
}
26-
```
27-
28-
* The format of the different fields can be found [here](/docs/pos/input-and-output-formats).
29-
30-
* The notification endpoint must respond with status code `200 OK` when the notification is processed successfully. The MobilePay notification service will retry notification calls in case of any other response than `200 OK`. The service will retry the call 3 times.
31-
32-
## Migrating to a different notification endpoint
33-
34-
In case an existing PoS has to be migrated to use a different notification, the integrator will have to contact MobilePay by writing an email to [[email protected]](mailto:[email protected]) asking for the change. The new URL will have to go through validation and whitelisting as described above.
35-
This included changing the mapping between the URL and the existing `CallbackAlias`. Close collaboration on the time of switching the URL is important to make sure the new endpoint is ready to receive notifications at the time of the change.
10+
:::

0 commit comments

Comments
 (0)