Le impostazioni di orchestrazione controllano l'unico record di orchestrazione associato al tuo account - il gateway di pagamento predefinito, gli URL di ritorno utilizzati dopo il checkout, gli URL di notifica utilizzati per i webhook di transazioni e link di pagamento, e la chiave di firma delle transazioni. Esiste un solo record di orchestrazione per account; nuovi record non vengono creati dalla dashboard, ma solo modificati.
Passare al contesto Perno Orchestration
- Fai clic sul selettore Contesto nella barra di navigazione superiore.
- Seleziona Perno Orchestration dall'elenco.
La dashboard ora mostra i dati in tempo reale per il contesto Perno Orchestration.
Apertura delle impostazioni di orchestrazione
- Fai clic su Perno Orchestration nella barra laterale sinistra.
La pagina delle impostazioni di orchestrazione mostra a destra il pannello Record, che conferma l'ID di orchestrazione dell'account e la data di creazione del record.
Configurazione delle impostazioni di orchestrazione
- Compila i campi delle impostazioni di orchestrazione:
| Campo | Descrizione |
|---|---|
| Gateway di pagamento predefinito | Il gateway utilizzato di default dall'orchestrazione: Stripe, Autopay, PayU. |
| URL di ritorno predefinito | Dove atterrano i clienti dopo il checkout quando non si applica un URL di ritorno più specifico. |
| URL di ritorno per successo | Dove atterrano i clienti dopo un pagamento riuscito. |
| URL di ritorno per annullamento | Dove atterrano i clienti se annullano il pagamento. |
| URL di notifica delle transazioni | L'URL webhook che riceve gli aggiornamenti sullo stato delle transazioni. |
| URL di notifica dei link di pagamento | L'URL webhook che riceve le notifiche relative ai link di pagamento. |
| Chiave di firma delle transazioni | Il segreto utilizzato per firmare i dati delle transazioni di pagamento. Non è il tuo token di autenticazione API. |
| Invia più webhook | Una casella di controllo che determina se vengono inviate più notifiche webhook per ogni evento. |
Come viene utilizzata la Chiave di firma delle transazioni
La Chiave di firma delle transazioni è un segreto utilizzato per firmare transazioni e link di pagamento - non viene utilizzata per autenticare le richieste API. Quando crei una transazione o un link di pagamento tramite l'API, costruisci un trx_hash con questa chiave:
trx_hash = SHA256("|" + amount + "|" + trx_id + "|" + transaction_signing_key)
L'API di Perno ricalcola lo stesso hash e verifica che corrisponda. In caso contrario, la richiesta viene rifiutata con un errore Wrong hash.
Chiave di firma delle transazioni vs. Token API
| Credenziale | Scopo |
|---|---|
| Token API | Ti autentica come utente. Inviato come Authorization: Token YOUR_API_TOKEN. |
| Chiave di firma delle transazioni | Utilizzata solo per costruire il trx_hash. Non viene mai inviata nella richiesta stessa. |
La maggior parte degli endpoint richiede solo il Token API. Anche la creazione di un link di pagamento richiede un trx_hash valido, costruito con la Chiave di firma delle transazioni.
Salvataggio delle impostazioni
I pulsanti Annulla e Salva impostazioni restano accessibili nella parte superiore della pagina mentre scorri i campi. Fai clic su Salva impostazioni per applicare le modifiche, oppure su Annulla per scartarle.
