Cost+Docs

Tilbagevendende betalinger (MIT)

Opsæt forhandlerinitierede tilbagevendende betalinger og abonnementer

Tilbagevendende betalinger giver dig mulighed for at opkræve kunder efter en tidsplan uden deres aktive deltagelse. Dette er et Merchant Initiated Transaction (MIT)-flow.

Sådan fungerer det

Det tilbagevendende flow har to faser:

  1. Første betaling — Kunden autentificerer og betaler og giver tilladelse til fremtidige opkrævninger
  2. Efterfølgende betalinger — Du opkræver kundens gemte kort uden deres interaktion

Fase 1: Første betaling

Opret en ordre med recurring_type: "first" og en schedule_type:

POST /v1/orders/
{
  "merchant_order_id": "first-recurring",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "first",
      "schedule_type": "scheduled"
    }
  ]
}

Tidsplantyper

TypeBeskrivelse
scheduledFast tidsplan (f.eks. månedligt abonnement)
unscheduledVariabel timing (f.eks. optankning når saldoen er lav)

Efter vellykket betaling skal du gemme vault_token og/eller first_transaction_id fra svaret.

Fase 2: Efterfølgende tilbagevendende betaling

Opkræv kunden ved hjælp af det gemte token:

POST /v1/orders/
{
  "merchant_order_id": "recurring-order",
  "currency": "EUR",
  "amount": 995,
  "transactions": [
    {
      "payment_method": "credit-card",
      "recurring_type": "recurring",
      "vault_token": "{vault_token}"
    }
  ]
}

Tilbagevendende betalinger returnerer ikke en payment_url i svaret, da ingen kundeinteraktion er nødvendig. Betalingen behandles med det samme.

Du kan bruge enten vault_token eller first_transaction_id til at referere til det gemte kort.

Tokengyldighed

Tilbagevendende tokens har en maksimal gyldighed på 1 år. Efter udløb skal du igangsætte en ny første betaling for at få et nyt token.

Sørg for, at dit system håndterer tokenudløb elegant. Opsæt en proces til at gen-autentificere kunder, inden deres tokens udløber.

Tilbagevendende vs. et-klik

FunktionTilbagevendende (MIT)Et-klik (CIT)
Initieret afForhandlerKunde
Kunde tilstedeNejJa
BrugssituationAbonnementer, planlagt faktureringHurtig checkout for tilbagevendende kunder
schedule_type påkrævetJaNej
payment_url returneretNejJa

Relaterede endpoints

  • Opret ordre — brug recurring_type og schedule_type i transaktionen til at opsætte eller opkræve tilbagevendende betalinger

On this page