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=Fattura%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.50.
Se specificato, il relativo campo viene precompilato e disabilitato.
nameCliente%20S.p.A..
Se specificato, il campo viene precompilato e disabilitato.
descriptionFattura%20%23A12.
Precompila la causale, che resta modificabile dall’utente.
typepay_now, installments oppure 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, come 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.
Il flusso Hosted Checkout + webhook può essere utilizzato in diversi touchpoint digitali e retail senza cambiare la logica di integrazione.
Genera un checkout direttamente da ERP, CRM o software verticale e registra l’esito nel tuo flusso tramite webhook.
Collega il pagamento a un processo applicativo mantenendo l’interfaccia di checkout nell’ambiente Inprimepay.
Porta Pay Now, rate e subscription in un checkout proprietario senza dover costruire la pagina di pagamento.
Genera il pagamento da totem, schermi touch e altri flussi fisici collegati a sistemi software.
Crea un checkout con importo e causale già impostati e porta il cliente al pagamento da un touchpoint di negozio.
Utilizza il tipo subscription nei flussi in cui
la configurazione del merchant e del provider supporta pagamenti ricorrenti.
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.
Il Piano API Inprimepay è proposto a 0€ come accesso alla soluzione. Restano applicabili le commissioni dei servizi e dei provider di pagamento utilizzati.
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}.
Sì. I parametri 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 subscription.
La disponibilità concreta dei relativi metodi dipende dai servizi attivati sul 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.
Passando un 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.
