Passa al contenuto principale

Flusso di pagamento

L'API Hero è concepita per essere semplice, efficiente e sicura.

Definizioni​

Prima di leggere le spiegazioni del nostro flusso di pagamento è importante avere alcune definizioni in mente:

  • Cliente: i tuoi clienti
  • Tipo di Pagamento: il modo in cui i clienti pagheranno Hero. Per la nostra Soluzione di Elaborazione, può essere solo in 1 rata, immediatamente.

Spiegazioni​

Ecco uno schema del nostro flusso di pagamento: Flusso di Pagamento

Fase 1-a: Richiesta CreatePayment​

Quando il cliente sceglie di pagare con Hero sul tuo Checkout, il tuo back-end dovrebbe richiedere di creare un pagamento.

In questa fase dovresti fornire alcune informazioni come un URI di reindirizzamento. Il cliente sarà reindirizzato a questo URI quando il suo pagamento sarà confermato.

Sicurezza

Per motivi di sicurezza controlliamo il valore dell'URI di reindirizzamento. Ad esempio, una richiesta che include URI che terminano con .localhost sarà bloccata. Utilizza un URI di reindirizzamento non sospetto 😇

Fase 1-b: Restituzione dell'ID del Pagamento​

Hero ti fornirà l'ID del pagamento (inizia con payment_id), salvalo, ne avrai bisogno.

Fase 2: Reindirizzamento alla pagina di pagamento utilizzando l'ID del Pagamento​

Ora che hai l'ID del Pagamento, puoi reindirizzare il cliente su questo uri:

  • Produzione: https://pay.heropay.eu/checkout/{payment_id}
  • Staging: https://staging.pay.heropay.eu/checkout/{payment_id}

Il tuo cliente sta ora pagando tramite Hero!

Se vuoi testare il nostro flusso di pagamento in staging, utilizza le seguenti informazioni della carta:

numero carta: 4010061700000021
scadenza: 12/26
CVV: 123

Fase 3: Pagamento​

Il tuo cliente paga sulla nostra pagina di pagamento. Le informazioni della sua carta vengono elaborate in modo sicuro.

Fase 4: Reindirizzamento​

Il tuo cliente ha finalizzato il pagamento, viene reindirizzato al tuo URI di reindirizzamento per convalidare il suo ordine sul tuo sito web.

Fase 5-a: Chiamata a getPaymentsInfos​

Puoi controllare le informazioni del pagamento per sapere se un pagamento è stato avviato o meno, e per sapere se alcuni importi sono stati o sono in fase di rimborso.

Chiama l'endpoint getPaymentsInfos con il corrispondente payment_id e quindi:

Fase 5-b: Controllo delle informazioni dei Pagamenti​

Il nostro back-end ti fornisce le informazioni rilevanti per questo pagamento:

  • Se il pagamento è avviato, significa che il cliente ha pagato
  • Se c'è un errore, informa il cliente che il pagamento non può essere finalizzato e contatta il nostro supporto a support@hero.fr per maggiori informazioni. Il pagamento non è stato finalizzato e il cliente dovrebbe provare a pagare di nuovo.