MobilePay Subscriptions


Beta

MobilePay Subscriptions integrationen til QuickPay er pt. lanceret i en beta-version.

Dette betyder at der stadigt kan og vil være små ting der ikke virker efter hensigten, og specielle tilfælde, hvor fx status på en betaling ikke sættes korrekt.

Man bør derfor endnu ikke bruge MobilePay Subscriptions gennem QuickPay til at modtage rigtige betalinger.

Læs mere under Beta, og følg med i de åbne issues.


MobilePay Subscriptions er MobilePays service til at modtage abonnementsbetalinger.

Efter aftalen er sat op, fungerer MobilePay Subscriptions i store træk som abonnementsbetalinger med kort gennem QuickPay.

Kunden dirigeres til et betalingslink, og kan herefter vælge MobilePay som en betalingsmetode. Herefter sendes kunden til MobilePays vindue, hvor de som en almindelige abonnementsbetaling skal indtaste telefonnummer, og herefter gennemfører transaktionen i MobilePay app’en.

Ved trækninger, er der dog en lille ændring ift. det normale flow. Et MobilePay Subscription abonnement kan ikke trækkes med det samme. I stedet vælger man ved oprettelsen af “recurring”-trækningen en dato, hvor selve pengene skal trækkes. Dette skal være minimum 24 timer i fremtiden og op til 126 dage. På den valgte dag trækkes pengene herefter automatisk.

Ansøg om aftale

Ansøg om MobilePay Subscription aftale på https://mobilepay.dk/hjaelp/mobilepay-til-erhverv/mobilepay-subscriptions/kom-i-gang/hvordan-faar-min-virksomhed-mobilepay-subcriptions#scroll

Opsæt MobilePay Subscriptions

Opsætningen forudsætter I har fået en aftale med MobilePay Subscriptions.

  1. I QuickPay Manager gå til Indstilling (Settings) > Indløsere (Acquirers) > MobilePay Subscription
  2. Klik på “Connect MobilePay Subscriptions”
  3. Indtast jeres CVR nr.
  4. Man bliver nu dirigeret til MobilePay Subscriptions login side. Efter login skal I godkende opsætningen med QuickPay. Ens bruger skal være en såkaldt “super-manager” på MobilePay kontoen, for at man kan godkende opsætningen.
  5. Man bliver nu dirigeret tilbage til QuickPay Manager, hvor I igen skal logge ind.
  6. Klik nu “Select provider” - Har I mere end et betalingssted opsat i MobilePay Subscriptions, skal I vælge hvilken der skal benyttes af QuickPay.
  7. Klik “Enable MobilePay Subscriptions”

I er nu klar til at modtage abonnementer med MobilePay.

Betalingsflow

MobilePay Subscriptions gennem QuickPay understøttes pt. kun gennem WooCommerce integrationen, eller ved at man integrere direkte gennem QuickPay API.

Oprettelse af abonnement

Et abonnement oprettes som normalt.

I betalingsvinduet kan kunden vælge MobilePay som betalingsmetode, eller man kan sende kunden direkte til MobilePay ved at bruge payment methods.

Herefter sendes kunden til MobilePays vindue, hvor de kan indtaste telefonnummer.

Herefter gennemfører og godkender kunden transaktionen i app’en og sendes herefter tilbage til betalingsvinduet eller direkte til butikken.

  • Ingen penge reserveres eller flyttes ved oprettelsen af et abonnement. Kun ved trækninger.

  • Åbnes betalingsvinduet på et device med MobilePay app’en installeret, bliver kunden sendt direkte til app’en.

  • Medsendes der et telefonnummer under på betalingen under invoice_address preudfyldes dette i det første vindue hos MobilePay.

Description

Ved oprettelsen af abonnementet skal der i QuickPay sættes en description.

Denne description vises for kunden i købsflowet i MobilePay.

Ved MobilePay Subscriptions må denne description være på max 30 tegn.

mobilepay-description-in-mobilepay-app

Merchant land og valuta

Det er kun muligt at få en MobilePay Subscription aftale hvis man er dansk eller finsk merchant.

For danske merchants understøttes kun DKK som valuta.

For finske merchants understøttes kun EUR som valuta.

Branding

MobilePay Subscription kræver at man benytter v2.1.19 eller nyere af branding.

Linket er udløbet …

Link er ikke længere tilgængelig. Kontakt virksomheden for yderligere oplysninger.

Får man ovenstående fejl er det som oftest et tegn på at man ikke bruger en opdateret version af sin branding.

Payment methods

Bruger man payments methods til at bestemme hvilke betalingsmetoder der skal vises i betalingsvinduet, skal man huske at tilføje mobilepay-subscriptions dvs. fx

payment_methods = visa, mobilepay-subscriptions

Herefter kan kunden vælge MobilePay som betalingsmetode i betalingsvinduet.

Ønsker man udelukkende at modtage betalinger gennem MobilePay Subscriptions, skal man bruge

payment_methods = mobilepay-subscriptions

Efterfølgende trækninger

Trækninger på oprettede abonnementer oprettes som normalt.

En trækning med MobilePay Subscriptions skal dog “varsles” mindst 24 timer i forvejen. Dvs. oprettes en trækning/recurring d. 25. august vil selve overførslen tidligst kunne gennemføres d. 27. august.

Overførselsdatoen sendes med ved oprettelsen af trækningen, dvs. i recurring request’et, ved at der medsendes en ekstra parameter.

due_date er den dato hvor selve trækningen skal ske.

Skal medsendes som string i formattet "YYYY-MM-DD".

Derudover kan man medsende en specific beskrivelse af trækningen.

description

Medsendes der ikke en description på trækningen genbruges description der blev sat ved oprettelsen af abonnementet.

API response på recurring request

Ved POST /subscriptions/{id}/recurring kommer der ikke noget response.

I stedet skal man kigge på location header, der vil vise URL til den betaling der oprettes ved trækningen. Fx.

location: https://api.quickpay.net/payments/231437087/operations/1

Eksempel på flow

Flowet er som følgende:

  1. d. 25. august kl. 16.00 oprettes en trækning (recurring) i QuickPay på et abonnement med MobilePay Subscription.

    due_date sættes til 27. august, som er den tidligst mulige.

    Betalingen oprettes i QuickPay, med state = new og en authorize operation med Approved.

    Denne betaling kan ikke captures.

  2. d. 27. august - MobilePay forsøger automatisk at hæve beløbet medsendt i trækningen.

    MobilePay forsøger at hæve trækningen omkring kl. 02, og skulle denne fejle, forsøger MobilePay med 2 timers mellemrum resten af dagen.

    Hvis trækningen gennemføres sendes der besked fra MobilePay til QuickPay, og betalingen ændrer automatisk status til state = processed og en capture operation oprettes som Approved

Flere trækninger med samme due_date

Det er kun muligt at lave én trækning på et abonnement med samme due_date

Efterfølgende trækninger med samme due_date som en eksisterende vil automatisk blive canceled.

Flere trækninger med forskellige due_date

Man kan godt lave flere fremtidige trækninger så længe at due_date er forskellig.

Dvs. d. 25. august, kan man godt varsle en trækning d. 27. august, og en trækning d. 27. september.

Beta

QuickPay integrationen til MobilePay Subscriptions er i første omgang lanceret i en beta-version.

Dette skyldes at MobilePay Subscriptions, som navnet antyder, dækker over et abonnementssystem. Og for at undgå at butikker får oprettet en masse kunder i et system, førend integrationen er gennemtestet, anbefaler vi i første omgang at man som butik tester systemet til sit flow.

Åbne issues

  • Cancel af subscription

    Hvis merchant canceler subscription gennem QuickPay, eller kunden “deleter” subscription gennem MobilePay app’en, afvises cancel-operation i systemet. Dette betyder også at state på subscription ikke ændres fra state=active til state=cancelled

  • Cancel af subscription af customer - callback

    Hvis kunden “deleter” subscription gennem MobilePay app’en, sendes der ingen callback til merchant. Dette ændres, så der sendes callback til callback-url der blev sat ved oprettelsen af abonnementet.

    Bliver subscription canceled af merchant sendes der callback hvis callback url bliver specificeret ved cancel requestet.

  • Cancel af efterfølgende trækning af customer - callback

    Hvis kunden afviser en efterfølgende trækning gennem MobilePay app’en, sendes der ingen callback til merchant. Dette ændres, så der sendes callback til callback-url der blev sat ved oprettelsen af trækningen.

    Bliver trækningen canceled af merchant sendes der callback hvis callback url bliver specificeret ved cancel requestet.

  • Kunden trykker “annuller” i browser inden de gennemfører i MobilePay

    I vinduet hvor der sker en nedtælling, imens kunden gennemfører købet i MobilePay app, er det muligt at trykke “Annuller” for kunden for at afbryde betalingen. Dette resultere pt. i at man vender tilbage til betalingsvinduet, men ender i et opdaterings loop, hvor kunden ikke kan komme videre uden at lukke vinduet og prøve betalingen igen forfra.

    Refundering af trækninger fejler

    Refunderinger af trækninger fejler.


Kontakt QuickPay Support
Brug for hjælp?

support@quickpay.net