Kaarten (Visa & Mastercard)

Overzicht

Accepteer creditcard- en betaalkaartbetalingen via de Cost+ API met de credit-card betaalmethode.

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

Ondersteunde kaartmerken

Merk	Type
Amex	Credit
Mastercard	Credit / Debit
Maestro	Debit
Visa	Credit / Debit
V Pay	Debit

Configuratieopties

Dynamische descriptor

Gebruik het veld dynamic_descriptor om een aangepaste tekst in te stellen die op het bank- of kaartoverzicht van uw klant verschijnt.

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

Klantnaam als kaarthoudernaam gebruiken

Stel use_customer_name_as_cardholder_name in op true om automatisch de naam van de klant uit de bestelling te gebruiken als kaarthoudernaam.

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

Aangepast kaartinvoerformulier

Als u uw eigen kaartinvoerformulier wilt bouwen in plaats van de hosted payment page te gebruiken, volg dan deze vier stappen.

Stap 1: Een bestelling aanmaken met een setup-token

Maak een bestelling aan en voeg setup_token: true toe aan de payment_method_details van de transactie. Dit vertelt Cost+ een setup-token te genereren dat u kunt gebruiken om kaartgegevens veilig te tokeniseren.

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"
  }'

De respons bevat een setup_token-waarde in de payment_method_details van de transactie:

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

Stap 2: Kaartgegevens tokeniseren

Stuur de kaart-PAN, vervaldatum en het setup-token naar het token-eindpunt. Dit slaat de kaart veilig op en retourneert een 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..."
  }'

Respons:

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

Stap 3: De transactie authenticeren

Dien het vault_token en de cvc in bij het authenticatie-eindpunt. Als 3D Secure vereist is, ontvangt u een redirect_url om de klant door te verwijzen naar de authenticatiepagina van hun bank.

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"
  }'

Respons:

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

Verwijs de klant door naar redirect_url om de 3D Secure-authenticatie te voltooien. Nadat de klant de authenticatie heeft voltooid (of geannuleerd), wordt deze terugverwezen naar uw return_url.

Stap 4: Bestellingsstatus pollen

Nadat de klant terugkeert van 3D Secure, poll de bestelling om de definitieve status te controleren.

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

De bestelling status gaat over naar een van de volgende:

Status	Betekenis
`completed`	Betaling is geslaagd
`cancelled`	Klant heeft geannuleerd of authenticatie is mislukt
`error`	Er is een fout opgetreden tijdens de verwerking
`expired`	De bestelling is verlopen voor voltooiing

Voor handmatige autorisatie- en capture-flows met kaartbetalingen, zie de handleiding Autorisatie / Capture / Void.

On this page