MobilePay Invoice

Overview

Invoice issuers

API endpoint reference

InvoiceDirect

InvoiceLink

Cancel invoice

Get invoice details

Get invoice status

User consent for InvoiceDirect

Error codes

Validations

Callbacks

Notifications

Visual examples

Payment screens

Review invoice

PDF example

InvoiceLink flow

🤫 Coming soon

Release Notes

Invoice 1.5

Invoice 1.4

Invoice 1.5 Release Notes

08 august 2022 - Callback intervals

We reduced intervals between callback batches from 30 to 5 seconds.

Invoice link now has an optional “RedirectUrl” property. It can be set when creating single or multiple Invoice links. User will be redirected to provided url after accepting invoice link payment for the future, or paying for it instantly. Redirect will happen with appropriate query parameters, i.e. if provided RedirectUrl value is “https://ProvidedUrl.com/” in case of accepted payment user will be redirected to “https://ProvidedUrl.com/?status=accepted” and in case of instant payment user will be redirected to “https://ProvidedUrl.com/?status=paid”. This feature supports both webUrls and deeplinks. If RedirectUrl property is not provided, everything will work as it did before.

24 march 2022 - Quantity no longer required when creating invoice

Article quantity is not required when creating invoice direct or invoice link.

If these parameters are passed with requrest, they will be ignored. Right now we automatically assign merchant’s country and currency codes to invoice or invoice link.

05 january 2022 - Added PaymentReference field to GET invoice details response

Invoice details GET response now has PaymentReference field.

InvoiceDirect user consent GET response now has GrantedOn field that shows exact time when the consent was granted.

10 november 2021 - Invoicing has become more flexible. These fields are optional:

Also only either InvoiceNumber or PaymentReference must be filled, because it is used in transaction reporting and reconciliation. Other one is optional.

More information in InvoiceDirect and InvoiceLink.

6 may 2021 - Added Sequence number to the callbacks

Sequence number can be used to determine the real order of the invoice events.

Invoice link data is deleted once it expires.

26 january 2021 - Visual design of Invoice PDF changed.

More information in Visual examples

You can now test InvoiceDirect user consent functionality in sandbox

Endpoint was added that can be used to imitate user granting or rejecting consent.

17 september 2020 - Sms notification time updates, for when future payment can’t be processed

Sms notification time is updated from 10:00 UTC to 07:00 UTC (09:00 DK time or 10:00 FI time)

03 september 2020 - Sms notification sending updates, for when future payment can’t be processed

Sms notification to user is sent at 10:00, after two attempts to make payment. If user completes payment manually after second attempt, but before he gets the notification, sms is not sent.

New feature: User consent for InvoiceDirect. Read more about user consent for InvoiceDirect here

Goal of this functionality is for invoice issuer to ask users phone number and consent to receive Invoices directly to MobilePay (InvoiceDirect).

10 august 2020 - Invoice 1.5 released