Passa al contenuto principale
In questa pagina

I metodi di pagamento alternativi (APM) possono richiedere un reindirizzamento, un cambio di app, un codice QR, un buono, l'approvazione bancaria o la conferma del fornitore in ritardo. Consultare il valore corrente da payment.data.status; se il pagamento si trova all'interno di una risposta dell'ordine, consultare order.payment.data.status.

Utilizzare questa pagina per il percorso specifico dell'APM. Per ogni definizione di stato e transizione diretta consentita, vedere Flusso e stati di pagamento.

Flusso APM standard#

La maggior parte degli APM inizia con pending. Alcuni confermano immediatamente; altri rimangono in attesa mentre il cliente agisce, quindi espongono processing mentre DEUNA attende la conferma del fornitore.

Diagramma di flusso
Customer completesactionImmediate confirmationConfirmedDeclinedDeclinedCancelledCancelledPayment window closes1pendingAwait customer orprovider2processingProvider confirmation3processedPayment confirmed4deniedAttempt unsuccessful5cancelledFinancial resolutionrequired6expiredCompletion windowclosed
Revisione o in sospesoRisultatoEccezione o arresto
StatoSignificatoAzione del commerciante
pendingL'azione del cliente, il reindirizzamento o la conferma del fornitore sono ancora in sospeso.Presentare next_action o le istruzioni per il metodo e mantenere il completamento bloccato.
processingIl metodo sta in attesa di un risultato del fornitore asincrono.Attendere o recuperare il pagamento definitivo; non riprovare prematuramente.
processedIl pagamento APM è stato completato.Applicare la politica di completamento e conservare i riferimenti al fornitore.
deniedIl tentativo corrente è stato non riuscito.Non completare; conservare il motivo e valutare se è consentito un nuovo tentativo.
cancelledIl metodo o il commerciante ha annullato il pagamento.Verificare se sono necessari rimborsi o annullamenti per fondi precedenti prima di chiudere l'ordine.
expiredLa finestra di completamento consentita è scaduta.Registrare il completamento del terminale e creare un nuovo pagamento per un tentativo di un altro cliente.

URL per l'azione del cliente e il ritorno#

Seguire il percorso specifico del metodo next_action Fornito da DEUNA. Un ritorno del browser, un ritorno dell'app o una pagina di successo visibile al cliente non dimostrano che il pagamento è stato completato. Conferma payment.data.status dopo che DEUNA ha ricevuto e elaborato il risultato del fornitore.

Se il cliente abbandona il reindirizzamento o chiude il browser, mantieni il pagamento non risolto fino a quando DEUNA non comunica un esito. Non dedurre denied, cancelledo expired dal comportamento dell'interfaccia utente.

Tempi di completamento#

Il tempo consentito per completare un pagamento è specifico per il metodo e la configurazione. La scadenza del voucher, la validità del QR, i timeout delle sessioni bancarie e i tempi di elaborazione del fornitore non sono intercambiabili.

Non calcolare lo stato finale del pagamento in base al tempo del browser o a un timer locale. Mantieni il pagamento bloccato e attendi fino a quando DEUNA non comunica. processed, denied, cancelledo expiredSe la tua esperienza utente mostra un conto alla rovescia, trattalo come indicazione di presentazione, a meno che il contratto del metodo non lo renda esplicito.

APM con funzionalità di autorizzazione#

Alcune connessioni APM supportano l'autorizzazione e la cattura. Questi metodi possono esporre authorizing, authorized, capturing, capturedo stati parziali di cattura invece del percorso standard per l'acquisto.

Quando un APM utilizza l'autenticazione, seguire le Linee guida per la gestione e l'annullamento delle transazioni con carta. Per gli stati di pagamento condivisi, ma verificare la compatibilità del metodo e del processore con il tuo referente tecnico di DEUNA (TAM). Non dedurre il supporto per l'acquisizione o l'annullamento di pagamenti in base alla presenza di uno stato nello stato globale.

Annullamento e rimborsi#

cancelled Non implica necessariamente lo stato finanziario finale. Se sono stati prelevati fondi, il pagamento può comunque procedere; refunded; se è stata effettuata un'autorizzazione, il pagamento può comunque procedere voided.

Dopo un'operazione di successo, processed Pagamenti e rimborsi possono essere gestiti attraverso partial_refunding, partial_refunded, refundinge refunded quando supportato dall'APM. Fare riferimento a MPR — Rimborsi multipli parziali Per i modalità supportate, i limiti di tempo, la concorrenza e il comportamento relativo al saldo disponibile.

Elenco di controllo dell'integrazione#

  1. Mantenere lo stato di "in attesa" fino al completamento del pagamento. pending o processing.
  2. Siga la acción siguiente sin considerar la devolución del cliente como confirmación de pago.
  3. Almacene las referencias del proveedor y los importi confirmati con ogni aggiornamento.
  4. Gestisca in modo idempotente le notifiche ritardate e ripetute del provider.
  5. Recuperi il pagamento autorizzato dopo un timeout del cliente o in caso di assenza di ritorno.
  6. Usa il riferimento di transizione convalidato per i percorsi di retry, rimborsi e riconciliazione non visualizzati nel flusso normale.