Configura l’Hosted Checkout.
Parti dall’URL del Merchant ID e aggiungi i parametri query necessari.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Integra “Pay with Inprimepay” tramite Hosted Checkout, query string, generazione Custom Payment Link server-to-server e webhook POST. Puoi precompilare il checkout, generare un token in tempo reale e validare le notifiche con firma HMAC-SHA256.
const checkout = "https://app.inprimepay.com/#/cpl/{MERCHANT_ID}" + "?amount=150.00" + "&name=Cliente%20S.p.A." + "&description=Invoice%20%23001" + "&type=installments" + "&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback"; window.location.href = checkout;
La documentazione prevede due modalità complementari: un’integrazione Low-Code basata su URL Hosted Checkout e una generazione dinamica server-to-server tramite OpenAPI.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.pay_now, installments o subscription.callback_url può includere parametri custom come order_id o reference.X-Api-Key.X-InPrimePay-Signature.Configura il Checkout Hosted, genera se necessario un Custom Payment Link dal tuo server e ricevi la notifica asincrona della transazione.
Parti dall’URL del Merchant ID e aggiungi i parametri query necessari.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Invia una POST all’endpoint OpenAPI usando il tuo Webhook Secret nell’header X-Api-Key.
POST /api/custom-payment-links/
openapi/generate
X-Api-Key: {WEBHOOK_SECRET}
Content-Type: application/json
Al completamento del pagamento ricevi un POST con evento payment.succeeded e firma HMAC-SHA256.
event: payment.succeeded header: X-InPrimePay-Signature
Reindirizza il cliente alla URL di pagamento sicura e passa i dati tramite query string per un’integrazione Low-Code rapida.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}
amount100.50If specified, the relevant field is pre-filled and disabled.
nameCliente%20S.p.A.If specified, the field is pre-populated and disabled.
descriptionFattura%20%23A12Pre-fill the reason, which can still be modified by the user.
typepay_now, installments or subscription.
callback_url?order_id=12345
o reference: vengono estratti automaticamente e
restituiti nel payload 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
Per ogni nuovo ordine puoi utilizzare l’endpoint OpenAPI. L’autenticazione avviene tramite il tuo Webhook Secret, reperibile nel Profilo della piattaforma.
POST https://api.inprimepay.com/api/custom-payment-links/openapi/generate
application/json
99.00.
X-Api-Key: {WEBHOOK_SECRET} Content-Type: application / json { "amount": 99.00, "clientName": "Cliente S.p.A.", "description": "Acquisto Servizio Premium" }
{
"token":
"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
Al completamento della transazione, il server Inprimepay invia una notifica POST asincrona all’endpoint specificato nel callback.
payment.succeeded.
eventId, chargeId, sessionId, customerId e orderId.
callback_url, as order_id, possono essere restituiti nel payload.
{
"event": "payment.succeeded",
"eventId": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
"timestamp": 1696772400,
"chargeId": 14592,
"sessionId": "cs_test_a1b2c3d4...",
"customerId": "{MERCHANT_ID}",
"orderId": "12345",
"amount": 100.50,
"currency": "eur",
"status": "Success",
"merchant": "InPrime Pay",
"originalTimestamp": "2024-05-13T10:35:42Z",
"paymentMethod": "card"
}
Per verificare che la notifica POST provenga legittimamente dai server Inprimepay, la richiesta include una firma di validazione.
X-InPrimePay-Signature
chargeId è indicato nella guida come univoco e stabile.
La guida tecnica allegata riporta sicurezza, metodi disponibili, velocità di integrazione e affidabilità dell’infrastruttura.
The Hosted Checkout + webhook flow can be used across multiple digital and retail touchpoints without changing the integration logic.
Generate a checkout directly from ERP, CRM, or vertical software and record the outcome in your flow via webhook.
Connect payment to an application process while keeping the checkout interface in the Inprimepay environment.
Bring Pay Now, installments, and subscriptions into a proprietary checkout without having to build the payment page.
Generate payments from kiosks, touch screens, and other physical flows connected to software systems.
Create a checkout with the amount and reason already set and take the customer to payment from a store touchpoint.
Use the type subscription in flows where the merchant and provider configuration supports recurring payments.
https://api.vostrosito.it/callback/payments.
X-Api-Key e per la validazione HMAC della firma webhook.
Le risposte essenziali sull’integrazione, incluse le specifiche aggiunte dalla Partner Technical Guide.
The Inprimepay API Plan is offered at €0 for access to the solution. Fees for the services and payment providers used still apply.
No. L’integrazione utilizza un Hosted Checkout Inprimepay: il tuo sistema costruisce il link e reindirizza il cliente all’URL di pagamento.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.
Yes. The parameters amount e name possono essere
passati via query string e, se presenti, vengono precompilati e resi non modificabili.
La documentazione prevede pay_now,
installments e subscriptionThe actual availability of the relevant methods depends on the services activated by the merchant.
Sì. La guida specifica che callback_url può includere
parametri custom come order_id o reference;
vengono estratti automaticamente e restituiti nel payload webhook.
Effettua una POST a
https://api.inprimepay.com/api/custom-payment-links/openapi/generate
usando il Webhook Secret nell’header X-Api-Key e
Content-Type: application/json.
amount e clientName sono indicati come obbligatori;
description è opzionale. La risposta restituisce un token univoco.
Passing a callback_url codificato, il server Inprimepay
invia al completamento della transazione una notifica webhook POST asincrona.
L’evento indicato nella guida è payment.succeeded.
Calcola l’HMAC-SHA256 del raw JSON request body utilizzando il tuo
Webhook Secret e confronta il risultato hex con l’header
X-InPrimePay-Signature.
Sì. La Partner Technical Guide indica che chargeId
è univoco e stabile.
Sì. Il modello Hosted Checkout + webhook è adatto anche a gestionali, applicazioni, piattaforme, ecommerce custom e flussi retail.
Hai a disposizione Hosted Checkout, parametri query, generazione server-to-server, token, webhook POST e validazione HMAC-SHA256. Per il supporto tecnico: assistenza@inprimepay.com.
