MobilePay Online API (v1)

The PSP's unique id of the merchant.

The merchant category code (MCC) is used to classify a business by the types of goods or services it provides. More information here: MCC.

The PSP's name of the merchant for billing purposes.

Billing currency of the merchant. Possible values are:
DKK
EUR
SEK
NOK

Merchant country code e.g. Denmark = DK. Use ISO 3166-1.

Identifier for the Merchant. Originates from the CreateMerchant response.

The display name of the merchant shown to the end-user. Is used for 'Dynamic Linking'. Must be the same as registered with the merchants Acquirer and in schemes.

The url of the logo shown to the end-user. Must be: 250x250 pixels, png or jpg served over a secure connection, must be https, and publicly available.

Merchant's order id.

Url of the merchant. Max length 150 char. Is used for 'Dynamic Linking'. If the merchant doesn't have a Url, use VAT number (international format) or use the merchantId from MobilePay, as this will also guarantee uniqueness.

PSP's unique reference to payment.

Order amount in minor unit. I.e. 4,95 must be given as 495.

Currency of the order. Must be alphabetic or numeric ISO 4217 code. Accepted codes: DKK, EUR, NOK, SEK, USD, GBP, 208, 978, 578, 752, 840, 826

Allowed card types for the payment, includes callback configuration per card type.

Id of the public key to be used for exchange of card data.

Where to redirect the user when the payment is complete. Must be fully qualified URL.

Url to be notified when a payment ends unsuccessful. Must be a fully qualified URL. Must be secured by TLS 1.2.
You're strongly encouraged to only set this property if your service handles the callback returned, i.e. reply with an http status 2xx for valid callbacks.

Set to true, if the payment will be automatically captured.
In MobilePay the payment will then be marked as captured immediately after the authorization is successful. If false, you need to mark it as captured as usual.

If set to true, the Visa part of the Danish co-branded Visa/Dankort will be preferred over the Dankort part. The card type given in the callback from MobilePay must still be respected.

Override the default language code for the payment.
Accepted values are DA|EN|FI.

Optional. The payment will fail if the MobilePay user age is below the given minimum age.

The PSP's unique id for the capture to ensure idempotency

Captured amount in minor unit. If the amount is lower than the originally authorized amount, it is a partial capture.

Time of the capture at the PSP.

The PSP's unique id of the cancel to ensure idempotency.

Cancelled amount in minor unit. If the amount is lower than the originally authorized amount, it is a partial cancel.

PSP's unique id of the refund to ensure idempotency.

Refunded amount in minor unit. If amount is lower than the originally authorized amount, it is a partial refund.

The timestamp of where the reservation is known to expire. This must be patched when a successful authorization is made. Also it must be patched should the expiration be prolonged. No need to patch it if reservation is captured or cancelled.

Reason code describing the reason for the authorization to fail.
Codes:
1000: rejected
1001: rejected, insufficient funds
1003: rejected, card expired
1004: rejected, fraud suspected
1005: rejected, soft blocked
1006: rejected, hard blocked
1007: rejected, web payment disabled for card
1008: soft reject, 3DS stepup required, ThreeDSecureUrl must be supplied
1009: after a successful 3DS stepup, PSP now has crypto and will retry authorization
1010: reject for payment invalidation, don´t forget to also call /invalidate endpoint
2000: error
2001: error, permanent - don't try again
2002: error, temporary - try again
3000: timeout - try again

Description of why the authorization failed.

Property indicating whether or not the authorization was successful. If false, reason code and reason message are required.

The VAT number of the acquirer to uniquely identify the acquirer used for this authorization attempt. Must be given for all reason codes in the 1000 range.
Used for our technical surveillance of the transactions and tracking errors.
Use the format described here: 'https://en.wikipedia.org/wiki/VAT_identification_number'.
Examples:
Clearhaus: DK33749996
Bambora: SE556233942301
Elavon: IE418442
Handelsbanken: SE502007786201
Nets: DK20016175
Swedbank: SE502017775301
Valitor: IS23243
Wirecard: DE201591202

The id of the merchant with the acquirer. Must be given for all reason codes in the 1000 range.

The id of the payment with the acquirer. Must be given for all reason codes in the 1000 range.