Aller au contenu
Référence API

Zahlungen

2 endpoints

Les descriptions des endpoints proviennent directement de l'API et sont en allemand.

Zahlungen auflisten

get/v1/payments

Spiegel der Zahlungen bei zahls.ch und Freika.

Paramètres

NomEmplacementType
limitfacultatifRequêteinteger
starting_afterfacultatifRequêtestring
statusfacultatifRequêtestring
providerfacultatifRequête"zahls" | "freika" | "mock"

Réponse 200PaymentList

NomTypeDescription
objectobligatoire"list"
dataobligatoirePayment[]
has_moreobligatoireboolean

Erreurs possibles

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Exemple
curl -X GET https://api.ladehase.com/v1/payments \n  -H "Authorization: Bearer lh_test_…"
Réponse 200
{
  "object": "list",
  "data": [
    {
      "id": "pay_8f1e2d3c4b5a6978",
      "object": "payment",
      "livemode": true,
      "session_id": "string",
      "provider": "zahls",
      "purpose": "string",
      "status": "string",
      "currency": "string",
      "amount": 1235,
      "captured_amount": 1235,
      "refunded_amount": 1235,
      "payment_method": "string",
      "card_masked": "string",
      "created_at": "string"
    }
  ],
  "has_more": true
}

Zahlung abrufen

get/v1/payments/{id}

Eine Zahlung.

Paramètres

NomEmplacementType
idobligatoireCheminstring

Réponse 200Payment

NomTypeDescription
idobligatoirestringID mit Präfix «pay_»
objectobligatoire"payment"
livemodeobligatoireboolean
session_idobligatoirestring | null
providerobligatoire"zahls" | "freika" | "mock"
purposeobligatoirestring
statusobligatoirestring
currencyobligatoirestring
amountobligatoireintegerBetrag in Rappen
captured_amountobligatoireintegerBelastet in Rappen
refunded_amountobligatoireintegerZurückerstattet in Rappen
payment_methodobligatoirestring | null
card_maskedobligatoirestring | null
created_atobligatoirestring

Erreurs possibles

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Exemple
curl -X GET https://api.ladehase.com/v1/payments/{id} \n  -H "Authorization: Bearer lh_test_…"
Réponse 200
{
  "id": "pay_8f1e2d3c4b5a6978",
  "object": "payment",
  "livemode": true,
  "session_id": "string",
  "provider": "zahls",
  "purpose": "string",
  "status": "string",
  "currency": "string",
  "amount": 1235,
  "captured_amount": 1235,
  "refunded_amount": 1235,
  "payment_method": "string",
  "card_masked": "string",
  "created_at": "string"
}