Obtener Pago con Tarjeta

Obtiene los detalles completos de un Pago con Tarjeta específico.

Endpoint

GET /v1/cards/payment-links/{id}

Autenticación

Requiere API Key con el ability card_payment_links:read.

Parámetros de Ruta

Parámetro	Tipo	Requerido	Descripción
`id`	string (UUID)	Sí	ID del Pago con Tarjeta

Ejemplo de Solicitud

curl -X GET "https://api.alohapay.co/api/external/v1/cards/payment-links/9d8f7a6b-5c4d-3e2f-1a0b-9c8d7e6f5a4b" \
  -H "X-API-KEY: tu_api_key_aqui"

const paymentLinkId = '9d8f7a6b-5c4d-3e2f-1a0b-9c8d7e6f5a4b';

const response = await fetch(
  `https://api.alohapay.co/api/external/v1/cards/payment-links/${paymentLinkId}`,
  {
    headers: {
      'X-API-KEY': 'tu_api_key_aqui'
    }
  }
);
const data = await response.json();

console.log('Status:', data.data.status);

import requests

payment_link_id = '9d8f7a6b-5c4d-3e2f-1a0b-9c8d7e6f5a4b'

headers = {
    'X-API-KEY': 'tu_api_key_aqui'
}

response = requests.get(
    f'https://api.alohapay.co/api/external/v1/cards/payment-links/{payment_link_id}',
    headers=headers
)
data = response.json()

print('Status:', data['data']['status'])

<?php
$paymentLinkId = '9d8f7a6b-5c4d-3e2f-1a0b-9c8d7e6f5a4b';

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.alohapay.co/api/external/v1/cards/payment-links/{$paymentLinkId}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: tu_api_key_aqui'
    ]
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

echo 'Status: ' . $data['data']['status'];

Respuesta Exitosa (200 OK)

{
  "success": true,
  "message": "Card payment link retrieved successfully",
  "data": {
    "id": "9d8f7a6b-5c4d-3e2f-1a0b-9c8d7e6f5a4b",
    "url": "https://checkout.alohapay.co/card/9d8f7a6b-5c4d-3e2f-1a0b-9c8d7e6f5a4b",
    "status": "completed",
    "customer_name": "Juan Pérez",
    "customer_email": "juan@ejemplo.com",
    "amount_usd": 100.50,
    "original_amount": 100.50,
    "original_currency": "USD",
    "exchange_rate": null,
    "description": "Factura #1234 - Servicio mensual",
    "redirect_url": "https://tu-servidor.com/pago-exitoso?orderId=1234",
    "completed_at": "2026-03-23T11:45:30.000000Z",
    "created_at": "2026-03-23T10:30:45.000000Z"
  }
}

Campos de Respuesta

Campo	Tipo	Descripción
`id`	string (UUID)	Identificador único del pago con tarjeta
`url`	string	URL de checkout para el pago
`status`	string	Estado: `active`, `completed`, `cancelled`
`customer_name`	string	Nombre del cliente
`customer_email`	string	Email del cliente
`amount_usd`	number	Monto en USD
`original_amount`	number	Monto original proporcionado
`original_currency`	string	Moneda original de la solicitud
`exchange_rate`	number/null	Tasa de cambio aplicada (null si USD)
`description`	string/null	Descripción del pago
`redirect_url`	string/null	URL de redirección configurada
`completed_at`	string/null	Fecha de completación (ISO 8601) - null si no completado
`created_at`	string	Fecha de creación (ISO 8601)

Errores Posibles

Pago con Tarjeta No Encontrado (404)

{
  "success": false,
  "code": "CARD_PAYMENT_LINK_NOT_FOUND",
  "message": "Card payment link not found"
}

Usuario No Encontrado (404)

{
  "success": false,
  "code": "USER_NOT_FOUND",
  "message": "User associated with API key not found"
}

Tabla de Errores

Código HTTP	Código de Error	Descripción
401	`INVALID_API_KEY`	API Key inválida o expirada
403	`insufficient_scope`	La API Key no tiene el ability `card_payment_links:read`
404	`CARD_PAYMENT_LINK_NOT_FOUND`	Pago con Tarjeta no encontrado o no pertenece al usuario
404	`USER_NOT_FOUND`	Usuario asociado a la API Key no encontrado