Pagos con Tarjeta

Los Pagos con Tarjeta te permiten crear enlaces de pago para aceptar pagos con tarjetas de crédito y débito en múltiples monedas.

¿Qué es un Pago con Tarjeta?

Un Pago con Tarjeta es una URL de checkout que puedes compartir con tus clientes para que realicen un pago con su tarjeta. Cada enlace contiene:

Monto a cobrar (con conversión automática a USD si es necesario)
Moneda del pago (14 monedas soportadas)
Nombre y email del cliente
Descripción del concepto
URL de redirección opcional después del pago

Monedas Soportadas

Moneda	Código
Dólar estadounidense	`USD`
Peso argentino	`ARS`
Boliviano	`BOB`
Real brasileño	`BRL`
Peso chileno	`CLP`
Peso colombiano	`COP`
Colón costarricense	`CRC`
Peso dominicano	`DOP`
Euro	`EUR`
Dólar guyanés	`GYD`
Peso mexicano	`MXN`
Sol peruano	`PEN`
Guaraní paraguayo	`PYG`
Peso uruguayo	`UYU`
Bolívar venezolano	`VES`

Casos de Uso

Cobros internacionales: Acepta pagos con tarjeta desde cualquier país
E-commerce: Integra pagos con tarjeta en tu tienda online
Servicios profesionales: Cobra a clientes con tarjeta de crédito o débito
Suscripciones: Genera enlaces de pago únicos por cliente

Estados del Pago con Tarjeta

Estado	Descripción
`active`	El enlace está disponible para recibir pagos
`completed`	El pago fue realizado exitosamente
`cancelled`	El enlace fue cancelado manualmente

Permisos Requeridos (Abilities)

Para trabajar con Pagos con Tarjeta, tu API Key necesita los siguientes abilities:

Operación	Ability
Crear	`card_payment_links:create`
Consultar	`card_payment_links:read`
Cancelar	`card_payment_links:cancel`

URL Base

Todos los endpoints de Pagos con Tarjeta utilizan la siguiente URL base:

https://api.alohapay.co/api/external/v1/cards/payment-links

Endpoints Disponibles

Método	Endpoint	Descripción
`POST`	`/v1/cards/payment-links`	Crear un nuevo pago con tarjeta
`GET`	`/v1/cards/payment-links/{id}`	Obtener detalles de un pago con tarjeta
`DELETE`	`/v1/cards/payment-links/{id}`	Cancelar un pago con tarjeta activo

Requisitos Previos

Para utilizar los Pagos con Tarjeta, tu cuenta debe tener los pagos con tarjeta habilitados. Si aún no los tienes configurados, contacta al equipo de soporte de Aloha Pay.

Próximos Pasos

Crear Pago con Tarjeta - Genera un nuevo enlace de pago con tarjeta
Obtener Pago con Tarjeta - Consulta los detalles de un pago
Cancelar Pago con Tarjeta - Cancela un enlace activo