AREA SVILUPPATORI · API & WEBHOOK

Integra Inprimepay. Nel tuo flusso.

Porta il checkout Inprimepay dentro app, software gestionali, piattaforme, kiosk ed ecommerce senza ricostruire da zero l’infrastruttura di pagamento. Genera il link Hosted Checkout, precompila i dati e ricevi l’esito tramite webhook.

Piano API 0€ Hosted Checkout Webhook POST
LOW-CODE URL + query string Checkout precompilato.
WEBHOOK payment_succeeded Notifica asincrona POST.
checkout.js
Hosted Checkout URL
const checkout =
"https://app.inprimepay.com/#/cp1/24718"
+ "?amount=150.00"
+ "&name=Mario%20Rossi"
+ "&description=Fattura%20%23123"
+ "&type=installments"
+ "&callback_url=https%3A%2F%2Fapi.tuo-sito.it%2Fcallback";

window.location.href = checkout;
Una documentazione pensata per andare online velocemente. La logica base utilizza Hosted Checkout e webhook: il pagamento resta nell’ambiente Inprimepay, il tuo sistema riceve l’esito.
0€ PIANO API
3 TIPI DI FLUSSO
POST WEBHOOK
Inprimepay Hosted Checkout
App Mobile / SaaS
Gestionale ERP / CRM
Ecommerce Checkout custom
Kiosk Retail / hardware
ARCHITETTURA

Il tuo software controlla il flusso. Inprimepay gestisce il checkout.

L’integrazione rapida è basata su un URL Hosted Checkout associato al Merchant ID. Il tuo sistema può precompilare importo, cliente, causale, tipo di pagamento e URL di callback.

  • Nessuna necessità di ricostruire l’interfaccia di pagamento.
  • Importo e nome cliente possono essere precompilati e resi non modificabili.
  • La causale può essere passata direttamente al checkout.
  • Puoi pre-selezionare pagamento immediato, rateale o ricorrente.
  • L’esito arriva al tuo endpoint tramite webhook asincrono.
Vedi i parametri →
QUICK START

Da zero al checkout in tre passaggi.

Il flusso pubblicato nella documentazione Inprimepay è volutamente lineare: costruisci l’URL, reindirizza il cliente e gestisci il webhook.

01 · URL

Costruisci il link.

Parti dall’URL base del tuo Merchant ID e aggiungi i parametri necessari.

https://app.inprimepay.com/
#/cp1/{MERCHANT_ID}
02 · CHECKOUT

Porta il cliente al pagamento.

Reindirizza l’utente all’Hosted Checkout con dati e tipo di pagamento già impostati.

?amount=150.00
&name=Mario%20Rossi
&type=installments
03 · WEBHOOK

Ricevi l’esito.

Al completamento della transazione Inprimepay invia una notifica POST al callback configurato.

{
  "event":"payment_succeeded",
  "status":"success"
}
PARAMETRI QUERY

Precompila ciò che serve al checkout.

I parametri attualmente pubblicati dalla documentazione Inprimepay permettono di controllare i principali dati del flusso Hosted Checkout.

amount
decimal
Importo del pagamento, ad esempio 198.50. Se specificato, il relativo campo viene precompilato e disabilitato.
name
string
Nome o ragione sociale del cliente, ad esempio Mario%20Rossi. Se specificato, il campo viene precompilato e disabilitato.
description
string
Causale del pagamento, ad esempio Fattura%20%23123. Precompila la causale, che resta modificabile dall’utente.
type
enum
Tipo di pagamento da pre-selezionare: pay_now, installments oppure subscription.
callback_url
url encoded
Endpoint che riceverà la notifica webhook POST. L’URL deve essere codificato.
WEBHOOK

Il pagamento termina. Il tuo sistema lo sa.

Al completamento della transazione, il server Inprimepay invia una notifica POST asincrona all’endpoint specificato nel callback.

Evento Il payload pubblicato utilizza l’evento payment_succeeded.
Dati transazione Il payload include charge ID, importo, valuta, stato, merchant, timestamp e metodo di pagamento.
Endpoint tuo Il callback viene inviato all’URL passato tramite callback_url.
Hai bisogno di supporto? →
POST /callback payment_succeeded
{
  "event": "payment_succeeded",
  "chargeId": "pj_3Pabc...",
  "amount": 198.50,
  "currency": "eur",
  "status": "success",
  "merchant": "Mario Rossi",
  "timestamp": "2024-05-13T10:35:42Z",
  "paymentMethod": "Visa •••• 4242"
}
DOVE USARLE

Non solo ecommerce.

Il flusso Hosted Checkout + webhook può essere utilizzato in diversi touchpoint digitali e retail senza cambiare la logica di integrazione.

</>

Software gestionali

Genera un checkout direttamente da ERP, CRM o software verticale e registra l’esito nel tuo flusso tramite webhook.

App e SaaS

Collega il pagamento a un processo applicativo mantenendo l’interfaccia di checkout nell’ambiente Inprimepay.

W

Ecommerce custom

Porta Pay Now, rate e subscription in un checkout proprietario senza dover costruire la pagina di pagamento.

Kiosk e self-service

Genera il pagamento da totem, schermi touch e altri flussi fisici collegati a sistemi software.

QR

Retail assistito

Crea un checkout con importo e causale già impostati e porta il cliente al pagamento da un touchpoint di negozio.

Pagamenti ricorrenti

Utilizza il tipo subscription nei flussi in cui la configurazione del merchant e del provider supporta pagamenti ricorrenti.

PER PARTIRE
Serve davvero poco.
1
Merchant ID Inprimepay È il riferimento utilizzato nell’URL base del checkout.
2
URL webhook Ad esempio https://api.vostrosito.it/callback/payments.
3
Account e metodi abilitati I metodi effettivamente disponibili dipendono dai servizi e provider attivati sul merchant.
FAQ SVILUPPATORI

Prima di passare il link al dev.

Le risposte essenziali sull’integrazione pubblicata.

Il Piano API ha un costo fisso?

Il Piano API Inprimepay è proposto a 0€ come accesso alla soluzione. Restano applicabili le commissioni dei servizi e dei provider di pagamento utilizzati.

Devo integrare un checkout da zero?

No. La documentazione pubblicata utilizza un Hosted Checkout Inprimepay: il tuo sistema costruisce il link e reindirizza il cliente all’URL di pagamento.

Posso passare importo e nome cliente?

Sì. I parametri amount e name possono essere passati via query string e, se presenti, vengono precompilati e resi non modificabili.

Quali tipi di pagamento posso pre-selezionare?

La documentazione pubblicata prevede pay_now, installments e subscription. La disponibilità concreta dei relativi metodi dipende dai servizi attivati sul merchant.

Come ricevo la conferma della transazione?

Passando un callback_url codificato, il server Inprimepay invia al completamento della transazione una notifica webhook POST asincrona.

Posso integrare Inprimepay in un gestionale o kiosk?

Sì. Il modello Hosted Checkout + webhook è adatto anche a gestionali, applicazioni, piattaforme e flussi retail custom.

Passa questa pagina al tuo sviluppatore.

Il punto di partenza è semplice: Merchant ID, Hosted Checkout, parametri query e un endpoint webhook.

Attiva Piano API 0€ →