MobilePay Subscriptions is a full-fledged HTTPS REST api using JSON as request/response communication media.
All dates and time-stamps use the ISO 8601 format: date format - YYYY-MM-DD
, date-time format - YYYY-MM-DDTHH:mm:ssZ
.
Amounts are enquoted with double quotation marks using 0.00
format, decimals separated with a dot.
When doing POST
, PATCH
or PUT
requests, Content-Type: application/json
HTTP header must be provided.
$ curl --request POST --header 'Content-Type: application/json' --url https://<mobile-pay-root>/resource --data '{}'
CorrelationId is an optional Guid header value which can be used to link requests on your back-end system to MobilePay Subscriptions business transaction for a more convenient debugging.
$ curl --header 'CorrelationId: 37b8450b-579b-489d-8698-c7800c65934c' --url https://<mobile-pay-root>/api/merchants/me/agreements
Use one of these endpoints to set REST callback authentication scheme and credentials:
PUT /api/providers/{providerId}/auth/oauth2
- set OAuth2 scheme which conforms to RFC 6749 section 4.4..PUT /api/providers/{providerId}/auth/basic
- set Basic auth scheme using username and password.PUT /api/providers/{providerId}/auth/apikey
- set a value which will be set to the Authorization header. API key must conform to the token68 specification as defined in RFC 7235 section2.1..Once the payment or agreement changes state, a callback will be done to the callback address, which is configurable via PATCH /api/providers/{providerId}
with path value /payment_status_callback_url
. Note that callbacks can only be delivered using ports 80 and 443.
In case the REST callback failed, 8 retries will be made using the exponential back-off algorithm, where N - next retry time, c - retry attempt number, R - second retry time in seconds (1st retry is an exception and is done after 5 seconds):
Billing your customers has never been easier before. This document explains how to make a technical integration to the MobilePay Subscription API. The audience for this document is either technical integrators acting on behalf of merchants or merchants themselves. You can find more information on our Developer Portal.
Our MobilePay Subscriptions REST api enables you to:
This document does not include detailed specification of the endpoints, responses and response codes. This information can be found in the API section of the Developer Portal.
You enroll to the Subscriptions Production via www.MobilePay.dk or the MobilePay Administration portal. Then you get access to the MobilePay Sandbox environment, where you can test the API. The Sandbox environment is located on The Sandbox Developer Portal You can use the Subscriptions API in test mode, which does not affect your live data or interact with the banking networks.
Once you sign-up you’ll receive a welcome email containing everything you need to get going right away. While we encourage you to start exploring our API right away, we highly recommend getting in touch with us at developer@mobilepay.dk before you go too far down your integration path. MobilePay has dedicated technical resources available to help you plan and build the right integration, avoid pitfalls, and get live as quickly as possible.
The MobilePay Developer Portal is a site where you will be able to find information about the products and available APIs and their documentations. It exposes live documentation that can be used for development. How to get access to the Developer Portal is described here.
The MobilePay Developer Portal is available at the following addresses:
Environment | Endpoint |
---|---|
Sandbox/Test | https://sandbox-developer.mobilepay.dk |
Production | https://developer.mobilepay.dk |