Vai al contenuto
Riferimento API

Zahlungen

2 endpoint

Le descrizioni degli endpoint provengono direttamente dall'API e sono in tedesco.

Zahlungen auflisten

get/v1/payments

Spiegel der Zahlungen bei zahls.ch und Freika.

Parametri

NomePosizioneTipo
limitfacoltativoQueryinteger
starting_afterfacoltativoQuerystring
statusfacoltativoQuerystring
providerfacoltativoQuery"zahls" | "freika" | "mock"

Risposta 200PaymentList

NomeTipoDescrizione
objectobbligatorio"list"
dataobbligatorioPayment[]
has_moreobbligatorioboolean

Errori possibili

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Esempio
curl -X GET https://api.ladehase.com/v1/payments \n  -H "Authorization: Bearer lh_test_…"
Risposta 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.

Parametri

NomePosizioneTipo
idobbligatorioPercorsostring

Risposta 200Payment

NomeTipoDescrizione
idobbligatoriostringID mit Präfix «pay_»
objectobbligatorio"payment"
livemodeobbligatorioboolean
session_idobbligatoriostring | null
providerobbligatorio"zahls" | "freika" | "mock"
purposeobbligatoriostring
statusobbligatoriostring
currencyobbligatoriostring
amountobbligatoriointegerBetrag in Rappen
captured_amountobbligatoriointegerBelastet in Rappen
refunded_amountobbligatoriointegerZurückerstattet in Rappen
payment_methodobbligatoriostring | null
card_maskedobbligatoriostring | null
created_atobbligatoriostring

Errori possibili

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Esempio
curl -X GET https://api.ladehase.com/v1/payments/{id} \n  -H "Authorization: Bearer lh_test_…"
Risposta 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"
}