> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagare un ordine della piattaforma AceDataCloud

> Platform API guide - Ace Data Cloud

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

| Voce | Contenuto |
| - | - |
| Metodo | `POST` |
| URL | `https://platform.acedata.cloud/api/v1/orders/{order_id}/pay/` |
| Autenticazione | I pagamenti con reindirizzamento gestito possono essere anonimi; gli altri metodi richiedono una sessione di accesso o un Account Token |
| Body | JSON, gli ordini non pagati devono fornire `pay_way` |

## 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

```shell theme={null}
export ORDER_ID='il tuo ID ordine Pending'

curl -X POST \
  "https://platform.acedata.cloud/api/v1/orders/${ORDER_ID}/pay/" \
  -H 'Content-Type: application/json' \
  -d '{"pay_way":"Stripe"}'
```

Metodi di pagamento che richiedono l'autenticazione:

```shell theme={null}
export PLATFORM_TOKEN='il tuo token account'

curl -X POST \
  "https://platform.acedata.cloud/api/v1/orders/${ORDER_ID}/pay/" \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{"pay_way":"X402"}'
```

`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

* [Crea un ordine di ricarica](https://platform.acedata.cloud/documents/platform-order-create)
* [Ottieni i dettagli dell'ordine](https://platform.acedata.cloud/documents/platform-order-detail)
* [Aggiorna lo stato dell'ordine](https://platform.acedata.cloud/documents/platform-order-refresh)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.