Zahlung erstellen

POST

/payments

Erstellt einen neuen Zahlungsversuch. Zahlungsart und Nettobetrag müssen angegeben werden. Je nach Zahlungsmethode kann die Antwort eine Weiterleitungs-URL enthalten, die der Benutzer im Browser öffnen muss, um die Zahlung abzuschließen.

Authorizations

token

Request Body^required

The payment request payload

application/json

Payment creation request payload

object

net_val

required

Nettozahlungsbetrag (Realwert, z.B. 50.00 für 50.00 EUR). Der Gesamtbetrag inkl. Gebühren und MwSt. wird automatisch berechnet.

number

type

required

Zahlungstyp: “sepa” = SEPA-Lastschrift, “stored_card” = gespeicherte Karte

string

Allowed values: sepa stored_card

method_id

required

ID der Zahlungsmethode von GET /payment_methods (gespeicherte Karten-ID oder SEPA-Mandats-ID)

integer

Examples

Stored card payment

Example request for creating a payment with a previously saved credit/debit card

{
  "net_val": 100,
  "type": "stored_card",
  "method_id": 94
}

SEPA direct debit payment

Example request for creating a payment via SEPA direct debit using an existing mandate

{
  "net_val": 50,
  "type": "sepa",
  "method_id": 747
}

Responses

200

Payment created

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

bank_transfer

Bank transfer payment created

Example response for a bank transfer payment (no redirect, invoice created immediately)

{
  "id": 120,
  "created_at": 1750066200,
  "completed_at": 1750066200,
  "status": 100,
  "amount": 100,
  "net_val": 100,
  "vat_val": 0,
  "fee_val": 0,
  "currency": "EUR",
  "type": 6,
  "invoice": "/invoices/456",
  "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

bank_transfer

Bank transfer payment created

Example response for a bank transfer payment (no redirect, invoice created immediately)

{
  "id": 120,
  "created_at": 1750066200,
  "completed_at": 1750066200,
  "status": 100,
  "amount": 100,
  "net_val": 100,
  "vat_val": 0,
  "fee_val": 0,
  "currency": "EUR",
  "type": 6,
  "invoice": "/invoices/456",
  "error": null
}

400

Ungültige Eingabe

401

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

402

Es gibt nicht genug Guthaben oder Kreditlinie auf dem Account!

403

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

422

Die Anfrage war korrekt formatiert, konnte aber aufgrund semantischer Fehler nicht verarbeitet werden

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 -X POST 'https://api.lox24.eu/payments' \
  -H 'X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"net_val": 100.00, "type": "stored_card", "method_id": 94}' | jq

using System;
using System.Net.Http;
using System.Text;
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 content = new StringContent(
            "{\"net_val\": 100.00, \"type\": \"stored_card\", \"method_id\": 94}",
            Encoding.UTF8,
            "application/json"
        );

        var response = await client.PostAsync("https://api.lox24.eu/payments", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

package main

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

func main() {
  body := `{"net_val": 100.00, "type": "stored_card", "method_id": 94}`
  req, _ := http.NewRequest("POST", "https://api.lox24.eu/payments", strings.NewReader(body))
  req.Header.Set("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")
  req.Header.Set("Content-Type", "application/json")

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

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 body = "{\"net_val\": 100.00, \"type\": \"stored_card\", \"method_id\": 94}";
        var request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.lox24.eu/payments"))
                .header("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();

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

fetch('https://api.lox24.eu/payments', {
    method: 'POST',
    headers: {
        'X-LOX24-AUTH-TOKEN': 'YOUR_API_TOKEN',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ net_val: 100.00, type: 'stored_card', method_id: 94 })
})
.then(res => res.json())
.then(console.log);

<?php

$data = json_encode(['net_val' => 100.00, 'type' => 'stored_card', 'method_id' => 94]);

$ch = curl_init('https://api.lox24.eu/payments');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

echo $response;

import requests
import json

response = requests.post(
    'https://api.lox24.eu/payments',
    headers={
        'X-LOX24-AUTH-TOKEN': 'YOUR_API_TOKEN',
        'Content-Type': 'application/json'
    },
    data=json.dumps({'net_val': 100.00, 'type': 'stored_card', 'method_id': 94})
)
print(response.json())

Zahlung erstellen

Authorizations

Request Body required

Examples

Responses

200

Examples

Examples

400

401

402

403

422

429

Code Samples

Request Body^required