Configurar el pago alojado.
Empiece desde la URL del ID del comerciante y añada los parámetros de consulta necesarios.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Integra la opción "Pagar con Inprimepay" mediante Hosted Checkout, cadenas de consulta, generación de enlaces de pago personalizados de servidor a servidor y webhooks POST. Puedes rellenar automáticamente el formulario de pago, generar un token en tiempo real y validar las notificaciones con firmas HMAC-SHA256.
const pagar = "https://app.inprimepay.com/#/cpl/{MERCHANT_ID}" + "?cantidad=150.00" + "&name=Cliente%20S.pA" + "&description=Factura%20%23001" + "&type=installments" + "&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback"; window.location.href = checkout;
La documentación ofrece dos modos complementarios: una integración de bajo código basada en URL de Hosted Checkout y una generación dinámica de servidor a servidor a través de OpenAPI.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.pay_now, installments o subscription.callback_url puede incluir parámetros personalizados como order_id o reference.X-Api-Key.X-InPrimePay-Signature.Configura el proceso de pago alojado, genera un enlace de pago personalizado desde tu servidor si es necesario y recibe notificaciones de transacciones asíncronas.
Empiece desde la URL del ID del comerciante y añada los parámetros de consulta necesarios.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Envía una solicitud POST al punto final de OpenAPI utilizando tu clave secreta de webhook en el encabezado X-Api-Key.
POST /api/custom-payment-links/ openapi/generate X-Api-Key: {WEBHOOK_SECRET} Content-Type: application/json
Una vez completado el pago, recibirá una solicitud POST con el evento payment.succeeded y una firma HMAC-SHA256.
evento: payment.succeeded encabezado: X-InPrimePay-Signature
Redirija al cliente a la URL de pago segura y transmita los datos mediante cadenas de consulta para una integración rápida con poco código.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}
amount100.50Si se especifica, el campo correspondiente se rellenará previamente y se desactivará.
nameCliente%20S.p.A.Si se especifica, el campo se rellena automáticamente y se desactiva.
descriptionFattura%20%23A12Introduzca previamente el motivo, que el usuario podrá modificar.
typepay_now, installments o subscription.
callback_url?order_id=12345
o reference: se extraen automáticamente y se devuelven en la carga útil del webhook.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}?amount=150.00&name=Cliente%20S.p.A.&description=Fattura%20%23001&type=installments&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback
Para cada nuevo pedido, puede utilizar el punto final de OpenAPI. La autenticación se realiza mediante su clave secreta de webhook, que encontrará en su perfil de plataforma.
POST https://api.inprimepay.com/api/custom-payment-links/openapi/generate
application/json
99.00.
Clave X-Api: {SECRITO_DE_WEBHOOK} Content-Type: aplicación / json { "cantidad": 99.00, "nombre del cliente": "Cliente SpA", "Descripción": "Adquiera el servicio Premium" }
{
"simbólico":
"d7a8e2b1-4f4c-11eb-ae93-0242ac130002"
}
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}?token=d7a8e2b1-4f4c-...&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback%3Forder_id%3D12345
Una vez completada la transacción, el servidor de Inprimepay envía una notificación POST asíncrona al punto final especificado en la función de devolución de llamada.
payment.succeeded.
eventId, chargeId, sessionId, customerId e orderId.
callback_url, como order_id, puede devolverse en la carga útil.
{
"evento": "pago.exitoso",
"idEvento": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
"marca de tiempo": 1696772400,
"chargeId": 14592,
"id de sesión": "cs_test_a1b2c3d4...",
"IDdelcliente": "{ID_COMERCIO}",
"orderId": "12345",
"cantidad": 100.50,
"divisa": "eur",
"estado": "Éxito",
"comerciante": "InPrime Pay",
"marca de tiempo original": "2024-05-13T10:35:42Z",
"método de pago": "tarjeta"
}
Para verificar que la notificación POST proviene legítimamente de los servidores de Inprimepay, la solicitud incluye una firma de validación.
X-InPrimePay-Signature
chargeId En la guía se indica que es único y estable.
La guía técnica adjunta describe la seguridad, los métodos disponibles, la velocidad de integración y la fiabilidad de la infraestructura.
El flujo de pago alojado + webhook se puede utilizar en múltiples puntos de contacto digitales y de venta minorista sin modificar la lógica de integración.
Genera un proceso de pago directamente desde tu sistema ERP, CRM o software especializado, y registra el resultado en tu flujo mediante un webhook.
Vincule el pago a un proceso de solicitud manteniendo la interfaz de pago en el entorno de Inprimepay.
Integra los pagos inmediatos, las cuotas y las suscripciones en un proceso de pago propio sin necesidad de crear la página de pago.
Generar pagos desde quioscos, pantallas táctiles y otros flujos físicos conectados a sistemas de software.
Crea un proceso de pago con el importe y el motivo ya establecidos y guía al cliente hasta el pago desde un punto de contacto de la tienda.
Utilice el tipo subscription en flujos donde la configuración del comerciante y del proveedor admite pagos recurrentes.
https://api.vostrosito.it/callback/payments.
X-Api-Key y para la validación HMAC de la firma del webhook.
Las respuestas esenciales sobre la integración, incluyendo detalles específicos añadidos por la Guía Técnica para Socios.
El plan API de Inprimepay se ofrece a un precio de 0 € para acceder a la solución. Se aplican las tarifas correspondientes a los servicios y proveedores de pago utilizados.
No. La integración utiliza un sistema de pago alojado de Inprimepay: su sistema crea el enlace y redirige al cliente a la URL de pago.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.
Sí. Los parámetros amount e name Se pueden pasar a través de cadenas de consulta y, si están presentes, se precompilan y se hacen inmodificables.
La documentación incluye pay_now,
installments e subscriptionLa disponibilidad real de los métodos correspondientes depende de los servicios activados por el comerciante.
Sí. La guía especifica que callback_url puede incluir parámetros personalizados como order_id o reference; se extraen automáticamente y se devuelven en la carga útil del webhook.
Haz una PUBLICACIÓN para
https://api.inprimepay.com/api/custom-payment-links/openapi/generate
utilizando el secreto del webhook en el encabezado X-Api-Key e
Content-Type: application/json.
amount e clientName se indican como obligatorios;
description Esto es opcional. La respuesta devuelve un token único.
Pasar una callback_url codificado, el servidor Inprimepay envía una notificación webhook POST asíncrona al completarse la transacción. El evento indicado en la guía es payment.succeeded.
Calcula el HMAC-SHA256 del cuerpo de la solicitud JSON sin procesar utilizando tu secreto de webhook y compara el resultado hexadecimal con el encabezado.
X-InPrimePay-Signature.
Sí. La Guía Técnica para Socios indica que chargeId
Es único y estable.
Sí. El modelo Hosted Checkout + webhook también es adecuado para sistemas de gestión, aplicaciones, plataformas, comercio electrónico personalizado y flujos de venta minorista.
Disponemos de opciones como pago alojado, parámetros de consulta, generación de código servidor a servidor, tokens, webhooks POST y validación HMAC-SHA256. Para asistencia técnica: assistenza@inprimepay.com.
