Zahlungsstatus abrufen

GET

/payments/{id}

Gibt detaillierte Informationen zu einem bestimmten Zahlungsversuch zurück. Erfordert Authentifizierung; gibt nur Zahlungsversuche des authentifizierten Benutzers zurück.

Authorizations

token

Parameters

Path Parameters

required

Payment attempt ID

integer

>= 1

Zahlungsversuchs-ID

Responses

200

Payment details

Payment attempt details (JSON-LD)

object

@id

JSON-LD ID

string

@type

JSON-LD type

string

@context

One of:

string
object

string

Payment Attempt ID

integer

created_at

Creation date (unix timestamp)

integer

completed_at

Completion date (unix timestamp), null if not completed

integer | null

status

Payment status: 0 = New, 10 = In Progress (before request), 20 = In Progress (after request), 100 = Done, 200 = Canceled by user, 300 = Canceled by timeout, 400 = Canceled by admin, 1000 = Error

integer

Allowed values: 0 10 20 100 200 300 400 1000

amount

Total payment amount

number

net_val

Net cost value

number

vat_val

VAT value

number

fee_val

Fee value

number

currency

Ihre Währung

string

default: EUR

Allowed values: EUR CHF

type

Payment method: 1 = SEPA, 6 = Bank Transfer, 7 = PayPal, 8 = Sofort, 91 = Stored Card, 92 = New Card

integer

Allowed values: 1 6 7 8 91 92

invoice

URI to related invoice, null if not yet created

string | null

error

Error message if payment failed, null otherwise

string | null

Examples

payment_jsonld

Payment attempt detail (JSON-LD)

Example response for GET /payments/{id} with Accept: application/ld+json

{
  "@id": "/payments/123",
  "@type": "PaymentAttempt",
  "id": 123,
  "created_at": 1750152600,
  "completed_at": null,
  "status": 20,
  "amount": 121.38,
  "net_val": 100,
  "vat_val": 19.38,
  "fee_val": 2,
  "currency": "EUR",
  "type": 7,
  "invoice": null,
  "error": null
}

Payment attempt details

object

Zahlungsversuchs-ID

integer

created_at

Erstellungsdatum (Unix-Zeitstempel)

integer

completed_at

Abschlussdatum (Unix-Zeitstempel), null wenn nicht abgeschlossen

integer | null

status

Zahlungsstatus: 0 = Neu, 10 = In Bearbeitung (vor Anfrage), 20 = In Bearbeitung (nach Anfrage), 100 = Erledigt, 200 = Vom Benutzer abgebrochen, 300 = Durch Zeitüberschreitung abgebrochen, 400 = Vom Administrator abgebrochen, 1000 = Fehler

integer

Allowed values: 0 10 20 100 200 300 400 1000

amount

Gesamtzahlungsbetrag

number

net_val

Nettobetrag

number

vat_val

MwSt.-Wert

number

fee_val

Gebührenwert

number

currency

Währungscode

string

default: EUR

Allowed values: EUR CHF

type

Zahlungsmethode: 1 = SEPA, 6 = Überweisung, 7 = PayPal, 8 = Sofort, 91 = Gespeicherte Karte, 92 = Neue Karte

integer

Allowed values: 1 6 7 8 91 92

invoice

URI zur zugehörigen Rechnung, null wenn noch nicht erstellt

string | null

error

Fehlermeldung wenn die Zahlung fehlgeschlagen ist, null sonst

string | null

paid_with_id

ID der verwendeten Zahlungsmethode (gespeicherte Karten-ID oder SEPA-Mandats-ID), null falls nicht zutreffend

Examples

payment_json

Payment attempt detail

Example response for GET /payments/{id} (payment with redirect URL)

{
  "id": 123,
  "created_at": 1750152600,
  "completed_at": null,
  "status": 20,
  "amount": 121.38,
  "net_val": 100,
  "vat_val": 19.38,
  "fee_val": 2,
  "currency": "EUR",
  "type": 7,
  "invoice": null,
  "error": null
}

401

Kunden-Nr oder API Key sind ungültig oder inaktiv!

403

Account ist noch nicht innerhalb von 24h nach Registrierung aktiviert. Bitte warten oder Support kontaktieren

404

Quelle nicht gefunden

429

Die IP-Adresse wurde vorübergehend blockiert, da in kurzer Zeit viele Anfragen mit ungültigen Anmeldeinformationen gesendet wurden. Bitte warten Sie und versuchen Sie es später.

Code Samples

curl -s 'https://api.lox24.eu/payments/123' -H 'X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN' | jq

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN");

        var response = await client.GetStringAsync("https://api.lox24.eu/payments/123");
        Console.WriteLine(response);
    }
}

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.lox24.eu/payments/123", nil)
  req.Header.Set("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.lox24.eu/payments/123"))
                .header("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")
                .GET()
                .build();

        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

<?php

$ch = curl_init('https://api.lox24.eu/payments/123');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;