Crear un pago

POST

/payments

Crea un nuevo intento de pago. Se debe proporcionar el tipo de pago y el coste neto. Dependiendo del método de pago, la respuesta puede incluir una URL de redirección que el usuario debe abrir en un navegador para completar el pago.

Authorizations

token

Request Body^required

The payment request payload

application/json

Payment creation request payload

object

net_val

required

Importe neto del pago (valor real, ej. 50.00 para 50.00 EUR). El total incluyendo comisiones e IVA se calcula automáticamente.

number

type

required

Tipo de pago: “sepa” = débito directo SEPA, “stored_card” = tarjeta guardada

string

Allowed values: sepa stored_card

method_id

required

ID del método de pago de GET /payment_methods (ID de tarjeta guardada o mandato SEPA)

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

Moneda

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

ID del intento de pago

integer

created_at

Fecha de creación (timestamp Unix)

integer

completed_at

Fecha de finalización (timestamp Unix), null si no completado

integer | null

status

Estado del pago: 0 = Nuevo, 10 = En progreso (antes de la solicitud), 20 = En progreso (después de la solicitud), 100 = Completado, 200 = Cancelado por el usuario, 300 = Cancelado por tiempo de espera, 400 = Cancelado por el administrador, 1000 = Error

integer

Allowed values: 0 10 20 100 200 300 400 1000

amount

Importe total del pago

number

net_val

Valor del coste neto

number

vat_val

Valor del IVA

number

fee_val

Valor de la comisión

number

currency

Código de moneda

string

default: EUR

Allowed values: EUR CHF

type

Método de pago: 1 = SEPA, 6 = Transferencia, 7 = PayPal, 8 = Sofort, 91 = Tarjeta guardada, 92 = Nueva tarjeta

integer

Allowed values: 1 6 7 8 91 92

invoice

URI a la factura relacionada, null si aún no se ha creado

string | null

error

Mensaje de error si el pago falló, null en caso contrario

string | null

paid_with_id

ID del método de pago utilizado (ID de tarjeta guardada o mandato SEPA), null si no aplica

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

Entrada no valida

401

El ID de cliente o la clave API no están activos o no son válidos.

402

No hay fondos suficientes en su cuenta.

403

La cuenta no está activada. Espere o póngase en contacto con el servicio de asistencia.

422

La solicitud estaba bien formada pero no se pudo procesar debido a errores semánticos

429

La dirección IP fue bloqueada temporalmente, ya que durante poco tiempo se enviaron muchas solicitudes con credenciales no válidas. Espere y pruebe más tarde.

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())

Crear un pago

Authorizations

Request Body required

Examples

Responses

200

Examples

Examples

400

401

402

403

422

429

Code Samples

Request Body^required