AREA sviluppatori

Documentazione API Webhook

Implementa inprimepay in qualsiasi app, piattaforma o checkout tramite la documentazione API open source. Invia questa pagina al tuo sviluppatore.

Gateway Esterno: "Pay with InPrimePay"
Guida all'integrazione rapida via Checkout Hosted & Webhooks.
1
Configurazione link

Reindirizzare il cliente finale alla URL di pagamento sicura. I dati vengono passati via query string per un'integrazione Low-Code rapida e sicura.

URL Base: https://app.inprimepay.com/#/cp1/{MERCHANT_ID}

Parametri Query:
  • amount: Importo es. 198.50. Se specificato, il relativo campo nell'interfaccia di pagamento viene precompilato e disabilitato (non modificabile dall'utente).
  • name: Nome/Ragione Sociale del cliente es. Mario%20Rossi. Se specificato, il relativo campo nell'interfaccia viene precompilato e disabilitato (non modificabile dall'utente).
  • description: Causale es. Fattura #%123. Precompila il campo causale (modificabile dall'utente).
  • type: Tipo di pagamento da pre-selezionare: pay_now (Pay Now), installments (Installments), subscription (Subscription).
  • callback_url: URL per la notifica Webhook (POST). Deve essere codificato (URL-encoded).
Esempio di Link Completo:
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
2
Notifica pagamento (Webhook)

Al completamento della transazione, il nostro server invia una notifica POST asincrona al vostro endpoint.

{
  "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"
}
3
Punti di forza
Massima Sicurezza: Compliance PCI-DSS di livello 1.
Metodi Multipli: Carte, Klarna, Satispay.
Velocità: Integrazione completabile in pochi minuti.
Affidabilità: Uptime del 99.9% garantito.
4
Requisiti per l'avvio

Per procedere con l'attivazione, il partner dovrà fornire:

  • L'URL del Webhook es. https://api.vostrosito.it/callback/payments