Passa al contenuto principale

Usa questa operazione dal backend del merchant per elaborare il token di un ordine esistente o un ordine incluso nella richiesta. DEUNA applica le connessioni di pagamento e la configurazione di routing, rischio e acquisizione del merchant.

Header#

4
X-Api-KeystringObbligatorio
Chiave privata dell’applicazione merchant convalidata dall’API Gateway.
Esempio YOUR_PRIVATE_API_KEY
AuthorizationstringFacoltativo
Contesto facoltativo dell’utente autenticato per metodi di pagamento e strumenti salvati.
Esempio Cuscinetto USER ACCESS TOKEN
X-Store-CodestringFacoltativo
Contesto dello store quando esiste una configurazione specifica per store.
Esempio principale
Content-TypestringObbligatorio
Deve essere applicazione/json.

Parametri del percorso#

0
Questo endpoint non ha parametri del percorso.

Corpo della richiesta#

8
order_tokenstringFacoltativo
Token di un ordine esistente. Invia questo campo o un oggetto ordine che DEUNA può creare.
orderobjectFacoltativo
Dati dell’ordine quando il pagamento deve crearlo ed elaborarlo in una sola richiesta.
payer_infoobjectObbligatorio
Identità del cliente. L’API richiede payer_info.email Strumento e dati di connessione usati per elaborare il pagamento.
Mostra attributi figli
payer_info.emailstringObbligatorio
E-mail del cliente utilizzata per identificare il payer.
payer_info.external_user_idstringFacoltativo
Identificatore del cliente nel sistema di commerciante.
payment_sourceobjectObbligatorio
Contesto cliente, dispositivo, browser e rischio per i servizi antifrode configurati.
Mostra attributi figli
payment_source.method_typestringObbligatorio
Tipo di metodo di pagamento, come ad esempio credit_card o un portafoglio supportato.
payment_source.payment_methodstringFacoltativo
Token prodotto da un'integrazione client DEUNA.
payment_source.payment_method_idstringFacoltativo
Identificatore del processore di pagamento Merchant quando il flusso richiede uno.
payment_source.card_infoobjectFacoltativo
Dettagli carta tokenizzati o conformi al PCI per i flussi di carte.
anti_fraud_infoobjectFacoltativo
Destinazioni di reindirizzamento per esito positivo, attesa, rifiuto, annullamento o errore.
callback_urlsobjectFacoltativo
Campi specifici del provider o del metodo di pagamento selezionato.
specific_fieldsobjectFacoltativo
Contesto dell’abbonamento quando l’acquisto crea o rinnova un abbonamento supportato.
subscriptionobjectFacoltativo
Contesto dell’abbonamento quando l’acquisto crea o rinnova un abbonamento supportato.

Inizia con un ordine completo del settore#

Il order Il campo sopra accetta lo stesso contesto aziendale modellato dall'API Orders. Per un recupero e un flusso di retry più chiari, crea prima l'ordine, mantieni le order_token, e invia il token in questa richiesta.

Restituisce l’ordine elaborato con#

Restituisce l’ordine elaborato, incluso il relativo order_token, il tipo di ordine, lo stato risultante, le informazioni di pagamento e quelle sull’abbonamento, quando applicabili. Considera lo stato restituito come fonte attendibile e prosegui il monitoraggio asincrono tramite i webhook del merchant.

Il pagamento è stato elaborato. Controlla gli stati dell’ordine e del pagamento per conoscere l’esito commerciale.

200La richiesta non è valida o non contiene i dati obbligatori del pagatore o della fonte di pagamento.
400La chiave privata o il contesto di autorizzazione del cliente non è valido.
401L’operazione è in conflitto con lo stato corrente dell’ordine o con una richiesta idempotente precedente.
409Il limite di richieste è stato superato. Rispetta
429Retry-After quando viene restituito. Idempotenza

Il Gateway applica l’idempotenza a questa operazione. Invia una#

stabile per lo stesso tentativo commerciale e riutilizza la stessa chiave e lo stesso corpo dopo un errore di rete. Usa una nuova chiave per un tentativo diverso. X-Idempotency-Key Genera la chiave nel backend del merchant, mai nel browser o nell’app mobile.

  • Non riutilizzare una chiave con un corpo diverso.
  • Consulta l’ordine prima di avviare un nuovo tentativo quando l’esito non è certo.
  • Riconcilia un esito incerto recuperando l’ordine prima di avviare un nuovo tentativo.

voce completa dell’endpoint , l’, Autenticazionee Codici di errore.