Kort (Visa & Mastercard)

Oversigt

Modtag kredit- og betalingskortbetalinger via Cost+ API'et ved hjælp af betalingsmetoden credit-card.

{
  "transactions": [
    {
      "payment_method": "credit-card"
    }
  ]
}

Understøttede kortmærker

Mærke	Type
Amex	Kredit
Mastercard	Kredit / Debet
Maestro	Debet
Visa	Kredit / Debet
V Pay	Debet

Konfigurationsmuligheder

Dynamisk deskriptor

Brug feltet dynamic_descriptor til at angive en tilpasset kontoudskrifttekst, der vises på kundens bank- eller kontoudskrift.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "dynamic_descriptor": "My Store Order 123"
      }
    }
  ]
}

Brug kundens navn som kortholders navn

Sæt use_customer_name_as_cardholder_name til true for automatisk at bruge kundens navn fra ordren som kortholders navn.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "use_customer_name_as_cardholder_name": true
      }
    }
  ]
}

Tilpasset kortindtastningsformular

Hvis du vil bygge din egen kortindtastningsformular i stedet for at bruge den hostede betalingsside, skal du følge disse fire trin.

Trin 1: Opret en ordre med et setup-token

Opret en ordre og inkluder setup_token: true i transaktionens payment_method_details. Dette fortæller Cost+ at generere et setup-token, du kan bruge til sikkert at tokenisere kortdetaljer.

curl -X POST https://api.costplus.online/v1/orders \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "EUR",
    "amount": 5000,
    "merchant_order_id": "order-001",
    "transactions": [
      {
        "payment_method": "credit-card",
        "payment_method_details": {
          "setup_token": true
        }
      }
    ],
    "return_url": "https://example.com/return",
    "webhook_url": "https://example.com/webhook"
  }'

Svaret vil inkludere en setup_token-værdi i transaktionens payment_method_details:

{
  "id": "order-uuid",
  "transactions": [
    {
      "id": "txn-uuid",
      "payment_method": "credit-card",
      "payment_method_details": {
        "setup_token": "st_abc123..."
      }
    }
  ]
}

Trin 2: Tokeniser kortdetaljer

Send kortets PAN, udløbsdato og setup-tokenet til token-endpointet. Dette gemmer kortet sikkert i en vault og returnerer et vault_token.

curl -X POST https://api.costplus.online/v1/tokens/ \
  -H "Content-Type: application/json" \
  -d '{
    "pan": "4111111111111111",
    "expiry_date": "1228",
    "setup_token": "st_abc123..."
  }'

Svar:

{
  "vault_token": "vt_xyz789..."
}

Trin 3: Autentificer transaktionen

Indsend vault_token og cvc til autentificeringsendpointet. Hvis 3D Secure er påkrævet, modtager du en redirect_url til at omdirigere kunden til deres banks autentificeringsside.

curl -X POST https://api.costplus.online/v1/orders/{order_id}/transactions/{transaction_id}/authenticate/ \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "vault_token": "vt_xyz789...",
    "cvc": "123"
  }'

Svar:

{
  "redirect_url": "https://3ds.bank.example.com/auth?id=..."
}

Omdiriger kunden til redirect_url for at gennemføre 3D Secure-autentificering. Når kunden har gennemført (eller annulleret) autentificeringen, omdirigeres de tilbage til din return_url.

Trin 4: Poll ordrestatus

Når kunden vender tilbage fra 3D Secure, skal du polle ordren for at tjekke den endelige status.

curl -X GET https://api.costplus.online/v1/orders/{order_id} \
  -u your-api-key:

Ordrens status vil skifte til en af:

Status	Betydning
`completed`	Betalingen var vellykket
`cancelled`	Kunden annullerede eller autentificering fejlede
`error`	Der opstod en fejl under behandlingen
`expired`	Ordren udløb inden gennemførelse

For manuelle autorisations- og hævningsflows med kortbetalinger, se vejledningen Autorisation / Hævning / Annullering.

On this page