Obtener estado del pago

GET

/payments/{id}

Devuelve información detallada sobre un intento de pago específico. Requiere autenticación; solo devuelve intentos de pago pertenecientes al usuario autenticado.

Authorizations

token

Parameters

Path Parameters

required

Payment attempt ID

integer

>= 1

ID del intento de pago

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

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

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

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

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

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

403

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

404

No se ha encontrado el recurso

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 '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;