Kort (Visa & Mastercard)

Översikt

Ta emot kredit- och betalkortbetalningar via Cost+ API:et med betalningsmetoden credit-card.

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

Kortmärken som stöds

Märke	Typ
Amex	Kredit
Mastercard	Kredit / Debet
Maestro	Debet
Visa	Kredit / Debet
V Pay	Debet

Konfigurationsalternativ

Dynamisk deskriptor

Använd fältet dynamic_descriptor för att ange en anpassad text som visas på kundens bank- eller kontoutdrag.

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

Använd kundnamn som kortinnehavarens namn

Ange use_customer_name_as_cardholder_name till true för att automatiskt använda kundens namn från ordern som kortinnehavarens namn.

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

Anpassat kortinmatningsformulär

Om du vill bygga ditt eget kortinmatningsformulär istället för att använda den hostade betalningssidan, följ dessa fyra steg.

Steg 1: Skapa en order med ett setup-token

Skapa en order och inkludera setup_token: true i transaktionens payment_method_details. Detta talar om för Cost+ att generera ett setup-token som du kan använda för att säkert tokenisera kortuppgifter.

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 innehåller ett setup_token-värde i transaktionens payment_method_details:

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

Steg 2: Tokenisera kortuppgifter

Skicka kortets PAN, utgångsdatum och setup-token till token-endpointen. Detta lagrar kortet säkert och returnerar en 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..."
}

Steg 3: Autentisera transaktionen

Skicka vault_token och cvc till autentiserings-endpointen. Om 3D Secure krävs får du en redirect_url för att omdirigera kunden till bankens autentiseringssida.

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=..."
}

Omdirigera kunden till redirect_url för att slutföra 3D Secure-autentiseringen. Efter att kunden slutfört (eller avbrutit) autentiseringen omdirigeras de tillbaka till din return_url.

Steg 4: Polla orderstatus

Efter att kunden återvänt från 3D Secure, polla ordern för att kontrollera slutgiltig status.

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

Orderns status övergår till en av:

Status	Betydelse
`completed`	Betalningen lyckades
`cancelled`	Kunden avbröt eller autentiseringen misslyckades
`error`	Ett fel uppstod under behandlingen
`expired`	Ordern löpte ut innan den slutfördes

För manuell auktorisering och debiteringsflöden med kortbetalningar, se guiden Auktorisering / Debitering / Makulering.

On this page