REST API Kreditkarten

Kartenzahlungen gehören weltweit zu den beliebtesten Zahlungsmethoden. Das The page Wording 0 1 was not found -- Please check/update the page name used in the MultiExcerpt-Include macro unterstützt alle gängigen Kartenmarken und ermöglicht Ihnen so, einen großen Kundenkreis weltweit zu erreichen.

Unterstützte Kartenmarken:

AirPlus
American Express (AMEX)
Argencard
Bancontact
Cabal
Carte 4etoiles
Carte Helline
Carte Helline 4etoiles
Cartes Bancaires
Cencosud
Union Pay International (UPI)
Dankort
Diners
Discover
Elo
Girocard
Hipercard
Ikano
IKEA Family Paycard
JCB
Maestro
MasterCard
Naranja
RuPay
Shopping
Troy
Visa

Erste Schritte

Für die Abwicklung der Kartenzahlung ist ein Vertrag mit einem lizenzierten Acquirer erforderlich.

The page Wording 0 1 was not found -- Please check/update the page name used in the MultiExcerpt-Include macro unterstützt die Verarbeitung von Karten über eine Vielzahl von Acquirern:

Acquirer	Unterstützte Regionen	Online-Zahlungen	POS-Zahlungen
1CS - First Cash Solution	Europa	Ja	Ja
Adyen	Australien Brasilien Kanada Europa HongKong Japan Malaysia Neuseeland Puerto Rico Singapur Vereinigte Arabische Emirate Vereinigte Staaten	Ja	Nein
AIBMS	Europa	Ja	Nein
Airplus	Global	Ja	Ja
Amercian Express	Global	Ja	Ja
AsiaPay	China Australien Indien Indonesien Malaysia Philippinen Singapur Taiwan Thailand Vietnam	Ja	Nein
Bank Frick	Europa	Ja	Nein
Banca Transilvania	Rumänien	Ja	Ja
Barclaycard	Europa	Ja	Nein
Be2bill/Dalenys	Europa	Ja	Nein
BNL Positivity	Europa	Ja	Nein
BNP Paribas	Europa	Ja	Ja
Payone	Europa	Ja	Ja
Card complete	Europa	Ja	Nein
Clearhaus (Unzer)	Europa	Ja	Nein
Concardis (Nets)	Europa	Ja	Ja
Finaro (Credorax)	Europa	Ja	Nein
Diners Club	Europa	Ja	Nein
EcomProcessing	Europa	Ja	Nein
Elavon Europe	Europa	Ja	Ja
Elavon US	USA Kanada	Ja	Nein
EMS	Europa	Ja	Nein
eService	Polen	Ja	Ja
Firserv Europe	Europa	Ja	Ja
Fiserv APAC (IPG)	Australien	Ja	Ja
Fiserv US	USA	Ja	Nein
Global Payments	Europa Malta Israel Australien Neuseeland Kanada Singapur HongKong	Ja	Nein
GMO	Japan	Ja	Nein
HSBC	Europa	Ja	Nein
iCard	Europa	Ja	Nein
Ingenico	Europa	Ja	Ja
Intercard	Europa	Ja	Nein
JPMC Tampa (Direct to Tandem)	USA Kanada	Ja	Ja
JPMC Salem (Stratus)	USA Kanada	Ja	Nein
Nets (via Nets PG)	Europa	Ja	Nein
Handelsbanken (via Nets PG)	Europa	Ja	Nein
Swedbank (via Nets PG)	Europa	Ja	Nein
Rapyd (via Nets PG)	Europa	Ja	Nein
PagBrasil	Brasilien	Ja	Nein
paygate.net	Südkorea	Ja	Nein
Paynetics	Europa	Ja	Nein
PayPal	Global	Ja	Nein
PayU (Europa)	Polen Tschechien Slowakei Ungarn	Ja	Nein
PayU CEE	Russland Rumänien Türkei	Ja	Nein
PayU Africa	Südafrika Nigeria Kenia	Ja	Nein
PayU Latam	Argentinien Brasilien Chile Kolumbien Mexiko Panama Peru	Ja	Nein
PayU India	Indien	Ja	Nein
PPRO	Europa	Ja	Nein
Raiffeisen Bank International	Osteuropa	Ja	Nein
RedSys (Sabadell, La Caixa)	Spanien	Ja	Nein
SIX	Europa	Ja	Ja
Nuvei (SafeCharge)	Europa	Ja	Nein
Worldpay (vormals Vantiv)	USA Kanada	Ja	Nein
VR Payment	Europa	Ja	Ja
Worldline	Europa	Ja	Nein
Worldpay	Europa Australien	Ja	Nein

Sobald Sie das Onboarding beim Acquirer erfolgreich abgeschlossen haben, wenden Sie sich an den The page Wording 0 1 was not found -- Please check/update the page name used in the MultiExcerpt-Include macro, um die Zahlungsmethode für Sie aktivieren zu lassen.

Integrationsoptionen

Kartenzahlungen sind in allen 3 von uns angebotenen Integrationsarten verfügbar:

Hosted Payment Page: Starten Sie die Hosted Payment Page durch Aufruf von Checkout-Sitzung anlegen.

See full sample request

{
  "transId": "6B29FC40-1067-B31D-00DD010662DA",
  "refNr": "24235345432",
  "amount": {
      "currency": "EUR",
      "value": 10000
  },
  "language": "en",
  "captureMethod": {
      "type": "AUTOMATIC"
  },
  "order": {
      "merchantReference": "112-445-34567",
      "numberOfArticles": 1,
      "creationDate": "2025-03-31T11:58:37Z",
      "invoiceId": "555-333-2222",
      "items": [
          {
              "id": "1",
              "sku": "19-402-DEU",
              "name": "BatteryPowerPack",
              "quantity": 1,
              "quantityUnit": "pcs",
              "taxRate": 0,
              "netPrice": 1000,
              "grossPrice": 1000,
              "totalTaxAmount": 0,
              "totalDiscountAmount": 0,
              "description": "BatteryPowerPack",
              "type": "physical",
              "productInfo": {
                  "brand": "Intel",
                  "categories": [
                      "Electronics Store",
                      "Computers",
                      "Desktops"
                  ],
                  "globalTradeItemNumber": "EAN",
                  "manufacturerPartNumber": "BOXNUC5CPYA",
                  "imageUrl": "https://www.exampleobjects.com/logo.png",
                  "productUrl": "https://www.estore.com/products/f2a8d7e34"
              }
          }
      ]
  },
  "urls": {
      "return": "https://my.callback.url.com/return",
      "cancel": "https://my.callback.url.com/cancel",
      "webhook": "https://my.callback.url.com/webhook"
  },
  "billingAddress": {
      "streetName": "Schwarzenbergstr",
      "streetNumber": "4",
      "city": "Bamberg",
      "country": "DEU",
      "postalCode": "96050"
  },
  "shipping": {
      "address": {
          "streetName": "Schwarzenbergstr",
          "streetNumber": "4",
          "city": "Bamberg",
          "country": "DEU",
          "postalCode": "96050"
      }
  },
  "statementDescriptor": "gadgets shop",
  "customerInfo": {
      "merchantCustomerId": "cus_1234567890abcdef",
      "customerType": "individual",
      "firstName": "Max",
      "lastName": "Mustermann",
      "email": "customer@example.com",
      "phone": {
          "countryCode": "+49",
          "number": "1236547890"
      },
      "salutation": "Miss",
      "title": "Dr",
      "gender": "female",
      "maidenName": "Mustermann",
      "middleName": "sam",
      "birthDate": "2001-01-01",
      "birthPlace": "Bamberg",
      "socialSecurityNumber": "123443534"
  },
  "channel": "ECOM"
}

Gehostete Formulare: Starten Sie gehostete Formulare durch Aufruf von Zahlung anlegen mit

{
  ...
  "paymentMethods": {
    "type": "CARD",
    "integrationType": "HOSTED"
  }
}

See full sampl,e request

{
  "transId": "6B29FC40-1067-B31D-00DD010662DA",
  "refNr": "24235345432",
  "amount": {
      "currency": "EUR",
      "value": 10000
  },
  "language": "en",
  "captureMethod": {
      "type": "AUTOMATIC"
  },
  "order": {
      "merchantReference": "112-445-34567",
      "numberOfArticles": 1,
      "creationDate": "2025-03-31T11:58:37Z",
      "invoiceId": "555-333-2222",
      "items": [
          {
              "id": "1",
              "sku": "19-402-DEU",
              "name": "BatteryPowerPack",
              "quantity": 1,
              "quantityUnit": "pcs",
              "taxRate": 0,
              "netPrice": 1000,
              "grossPrice": 1000,
              "totalTaxAmount": 0,
              "totalDiscountAmount": 0,
              "description": "BatteryPowerPack",
              "type": "physical",
              "productInfo": {
                  "brand": "Intel",
                  "categories": [
                      "Electronics Store",
                      "Computers",
                      "Desktops"
                  ],
                  "globalTradeItemNumber": "EAN",
                  "manufacturerPartNumber": "BOXNUC5CPYA",
                  "imageUrl": "https://www.exampleobjects.com/logo.png",
                  "productUrl": "https://www.estore.com/products/f2a8d7e34"
              }
          }
      ]
  },
  "urls": {
      "return": "https://my.callback.url.com/return",
      "cancel": "https://my.callback.url.com/cancel",
      "webhook": "https://my.callback.url.com/webhook"
  },
  "billingAddress": {
      "streetName": "Schwarzenbergstr",
      "streetNumber": "4",
      "city": "Bamberg",
      "country": "DEU",
      "postalCode": "96050"
  },
  "shipping": {
      "address": {
          "streetName": "Schwarzenbergstr",
          "streetNumber": "4",
          "city": "Bamberg",
          "country": "DEU",
          "postalCode": "96050"
      }
  },
  "statementDescriptor": "gadgets shop",
  "customerInfo": {
      "merchantCustomerId": "cus_1234567890abcdef",
      "customerType": "individual",
      "firstName": "Max",
      "lastName": "Mustermann",
      "email": "customer@example.com",
      "phone": {
          "countryCode": "+49",
          "number": "1236547890"
      }
  },
  "channel": "ECOM",
  "paymentMethods": {
      "integrationType": "HOSTED",
      "type": "CARD"
  }
}

Direkte Integration: Starten Sie die Direkte Integration durch Aufruf von Zahlung anlegen mit

{
  ...
  "paymentMethods": {
    "integrationType": "DIRECT",
    "type": "CARD",
    "card": {
        "number": "4242424242424242",
        "cardHolderName": "Max Mustermann",
        "expiryDate": "202801",
        "brand": "VISA",
        "securityCode": "123"
    }
  }
}

See full sample request

{
  "transId": "6B29FC40-1067-B31D-00DD010662DA",
  "refNr": "24235345432",
  "amount": {
      "currency": "EUR",
      "value": 10000
  },
  "captureMethod": {
      "type": "AUTOMATIC"
  },
  "browserInfo": {
      "acceptHeaders": "text",
      "ipAddress": "93.176.166.240",
      "javaEnabled": false,
      "javaScriptEnabled": true,
      "language": "EN",
      "userAgent": "Mozilla/5.0",
      "colorDepth": 4,
      "screenHeight": 800,
      "screenWidth": 1200,
      "timezoneOffset": "120"
  },
  "order": {
      "merchantReference": "112-445-34567",
      "numberOfArticles": 1,
      "creationDate": "2025-03-31T11:58:37Z",
      "invoiceId": "555-333-2222",
      "items": [
          {
              "id": "1",
              "sku": "19-402-DEU",
              "name": "BatteryPowerPack",
              "quantity": 1,
              "quantityUnit": "pcs",
              "taxRate": 0,
              "netPrice": 1000,
              "grossPrice": 1000,
              "totalTaxAmount": 0,
              "totalDiscountAmount": 0,
              "description": "BatteryPowerPack",
              "type": "physical",
              "productInfo": {
                  "brand": "Intel",
                  "categories": [
                      "Electronics Store",
                      "Computers",
                      "Desktops"
                  ],
                  "globalTradeItemNumber": "EAN",
                  "manufacturerPartNumber": "BOXNUC5CPYA",
                  "imageUrl": "https://www.exampleobjects.com/logo.png",
                  "productUrl": "https://www.estore.com/products/f2a8d7e34"
              }
          }
      ]
  },
  "billingAddress": {
      "streetName": "Schwarzenbergstr",
      "streetNumber": "4",
      "city": "Bamberg",
      "country": "DEU",
      "postalCode": "96050"
  },
  "shipping": {
      "address": {
          "streetName": "Schwarzenbergstr",
          "streetNumber": "4",
          "city": "Bamberg",
          "country": "DEU",
          "postalCode": "96050"
      }
  },
  "statementDescriptor": "gadgets shop",
  "customerInfo": {
      "merchantCustomerId": "cus_1234567890abcdef",
      "customerType": "individual",
      "firstName": "Max",
      "lastName": "Mustermann",
      "email": "customer@example.com",
      "phone": {
          "countryCode": "+49",
          "number": "1236547890"
      }
  },
  "channel": "ECOM",
  "paymentMethods": {
      "integrationType": "DIRECT",
      "type": "CARD",
      "card": {
          "number": "4242424242424242",
          "cardHolderName": "Max Mustermann",
          "expiryDate": "202801",
          "brand": "VISA",
          "securityCode": "123",
          "brandSelection": "MERCHANT"
      }
  }
}

.

Storno

Sie können eine Kartentransaktion stornieren, sofern sie noch nicht gebucht wurde. Stornierungen heben die Autorisierungssperre auf dem Konto des Karteninhabers auf, sodass keine Belastung erfolgt.

Um eine Stornierung durchzuführen, rufen Sie den Endpunkt Zahlung stornieren mit der payId der ursprünglichen Transaktion auf.

Buchung

Wenn Ihre ursprüngliche Kartenzahlung mi captureMethod.type=MANUAL übermittelt wurde, müssen Sie die Gelder nach der Autorisierung manuell buchen.

Dafür rufen Sie den Endpunkt Zahlung buchen mit der payId der ursprünglichen Transaktion auf.

Gutschrift

Gutschriften können für Kartenzahlungen entweder mit Referenz (verknüpft mit der ursprünglichen Transaktion) oder ohne Referenz (eigenständig) durchgeführt werden.

Gutschrift mit Referenz

Verwenden Sie dies, wenn die Gutschrift an eine zuvor gebuchte Transaktion gebunden ist. Rufen Sie den Endpunkt Gutschrift auf und geben die payId an.

Gutschrift ohne Referenz

Für eigenständige Rückerstattungen (z. B. Offline-Abrechnungsanpassungen) verwenden Sie die Gutschrift ohne Referenz. Da kein Bezug zur Zahlung besteht, sollten diese Gutschriften als völlig neue Transaktion eingereicht werden.

Wenden Sie sich an The page Wording 0 1 was not found -- Please check/update the page name used in the MultiExcerpt-Include macro, um diese Fuktion bei Bedarf für Sie zu aktivieren.

Gutschriften ohne Referenz zur ursprünglichen Zahlung verursachen höhere Kosten für Ihren Acquirer. Wenn Sie die Gutschrift häufig nicht der ursprünglichen Zahlung zuordnen können, sollten Sie Ihren Acquirer kontaktieren.

Space shortcuts

Page tree

Erste Schritte

Integrationsoptionen

Storno

Buchung

Gutschrift

Gutschrift mit Referenz

Gutschrift ohne Referenz

Paygate

Computop

Help

Intranet Tools