Skip to main content
Crea o aggiorna una sessione di pagamento per un ordine Pending. L’azione di pagamento accederà al canale di pagamento e potrebbe modificare lo stato dell’ordine; prima della chiamata è necessario confermare l’ID dell’ordine, l’importo e il metodo di pagamento.

​
Panoramica dell’interfaccia

​
Limiti del pagamento anonimo

L’accesso anonimo è destinato agli scenari in cui, dopo aver aperto un link di pagamento copiato, si perde la sessione di accesso; non richiede e non deve includere un Account Token a lungo termine. Le chiamate anonime:
  • consentono solo i metodi di pagamento con reindirizzamento gestito configurati dal server;
  • utilizzano sempre la pagina di pagamento desktop;
  • non possono riscattare ordini a prezzo zero;
  • sono soggette a limiti di frequenza per IP e per singolo ordine;
  • restituiscono una proiezione minima dell’ordine, senza account, Application o metadata interni.
I chiamanti autenticati devono essere il proprietario dell’ordine o un super amministratore. I metodi che richiedono il contesto utente, come X402 e lo scambio di ricompense, non possono essere chiamati anonimamente.

​
Esempi di richiesta

Metodi di pagamento che richiedono l’autenticazione:
pay_way utilizza i valori effettivi supportati dal modello dell’ordine, ad esempio WechatPay, AliPay, Stripe, Card, Airwallex, X402, PayPal, AppleIAP, Reward, BankTransfer. Non tutti i valori sono disponibili per le richieste anonime o per ogni sito.

​
Descrizione della risposta

La risposta in caso di successo è l’oggetto ordine aggiornato, che normalmente fornisce il punto di accesso al passaggio successivo tramite pay_url; i diversi metodi di pagamento possono anche restituire, in campi controllati, le informazioni necessarie al client per continuare il pagamento. Le risposte anonime utilizzano una whitelist minima di campi, mentre il proprietario autenticato ottiene i dettagli completi. Non fare affidamento su vecchi nomi di campo come payment_url, qr_code_url o payment_method; l’attuale contratto Order utilizza pay_url e pay_way.

​
Acquisti in-app iOS

Il proprietario dell’ordine che ha effettuato l’accesso può passare pay_way: "AppleIAP". Questa richiesta aggiorna l’ordine in attesa di pagamento in base a metadata.apple_price del piano selezionato e rimuove gli sconti, senza generare addebiti, assegnare crediti o restituire un link di pagamento. Gli ordini in attesa di pagamento meno recenti devono prima completare questo passaggio, quindi avviare il pagamento nativo Apple. È supportato solo un piano Usage con prodotto Apple e prezzo configurati; i piani non supportati o gli ordini in batch restituiscono 400. Dopo il pagamento nativo Apple, inviare transaction_id tramite /api/v1/orders/{id}/apple-verify/ per completare la verifica lato server e l’assegnazione dei crediti. La quantità di crediti proviene dal piano; l’importo utilizza il prezzo preimpostato indipendente in dollari USA di Apple, senza cumulazione di sconti membro o maggiorazioni del sito; l’importo addebitato nella valuta locale per altre regioni è soggetto alla pagina di conferma Apple.

​
Errori e tentativi

  • L’ordine non è Pending: restituisce 400; non creare ripetutamente sessioni di pagamento.
  • pay_way non fornito: gli ordini con importo diverso da zero restituiscono 400.
  • Una chiamata anonima utilizza un metodo non consentito o un ordine a prezzo zero: restituisce 403; riprovare dopo l’accesso come proprietario.
  • Autenticato ma non proprietario dell’ordine: restituisce 403.
  • Errore del canale di pagamento: non inviare nuovamente alla cieca; prima consulta i dettagli dell’ordine, conferma che sia ancora Pending, quindi riprova.

​
Interfacce correlate