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

# Opłacenie zamówienia na platformie AceDataCloud

> Platform API guide - Ace Data Cloud

Utwórz lub odśwież sesję płatności dla zamówienia `Pending`. Działanie płatnicze uzyska dostęp do kanału płatności i może zmienić status zamówienia, przed wywołaniem należy potwierdzić ID zamówienia, kwotę i metodę płatności.

## Przegląd interfejsu

| Pozycja | Treść |
| - | - |
| Metoda | `POST` |
| URL | `https://platform.acedata.cloud/api/v1/orders/{order_id}/pay/` |
| Uwierzytelnianie | Płatności z hostowanym przekierowaniem mogą być anonimowe; inne metody wymagają sesji logowania lub Account Token |
| Body | JSON, nieopłacone zamówienia muszą podać `pay_way` |

## Granice płatności anonimowych

Dostęp anonimowy służy do scenariusza, w którym sesja logowania zostaje utracona po otwarciu skopiowanego linku płatności, nie wymaga ani nie powinien zawierać długoterminowego Account Token. Wywołania anonimowe:

* zezwalają wyłącznie na skonfigurowane po stronie serwera metody płatności z hostowanym przekierowaniem;
* zawsze używają strony płatności dla komputerów stacjonarnych;
* nie mogą odebrać zamówień o zerowej cenie;
* podlegają limitowaniu według IP i pojedynczego zamówienia;
* zwracają minimalną projekcję zamówienia, bez konta, Application ani wewnętrznych metadata.

Uwierzytelniony wywołujący musi być właścicielem zamówienia lub superadministratorem. Metody wymagające kontekstu użytkownika, takie jak X402 i wymiana nagród, nie mogą być wywoływane anonimowo.

## Przykład żądania

```shell theme={null}
export ORDER_ID='你的 Pending 订单 ID'

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

Metody płatności wymagające uwierzytelnienia:

```shell theme={null}
export PLATFORM_TOKEN='你的账户令牌'

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` używa rzeczywistych wartości obsługiwanych przez model zamówienia, na przykład `WechatPay`, `AliPay`, `Stripe`, `Card`, `Airwallex`, `X402`, `PayPal`, `AppleIAP`, `Reward`, `BankTransfer`. Nie każda wartość jest dostępna dla żądań anonimowych ani w każdej witrynie.

## Opis odpowiedzi

Pomyślna odpowiedź jest zaktualizowanym obiektem zamówienia, zwykle udostępniającym punkt wejścia do następnego kroku przez `pay_url`; różne metody płatności mogą również zwracać w kontrolowanych polach informacje potrzebne klientowi do kontynuowania płatności. Odpowiedzi anonimowe używają minimalnej białej listy pól, uwierzytelniony właściciel otrzymuje pełne szczegóły.

Nie polegaj na starych nazwach pól, takich jak `payment_url`, `qr_code_url` lub `payment_method`; obecny kontrakt Order używa `pay_url` i `pay_way`.

## Zakupy wewnątrz aplikacji iOS

Zalogowany właściciel zamówienia może przekazać `pay_way: "AppleIAP"`. To żądanie aktualizuje oczekujące na płatność zamówienie zgodnie z `metadata.apple_price` wybranego pakietu i usuwa rabat, nie powoduje obciążenia, nie przyznaje punktów ani nie zwraca linku płatności. Starsze oczekujące na płatność zamówienia powinny najpierw wykonać ten krok, a następnie zainicjować natywną płatność Apple. Obsługiwany jest tylko jeden pakiet Usage ze skonfigurowanym produktem i ceną Apple; nieobsługiwane pakiety lub zamówienia zbiorcze zwracają `400`.

Po natywnej płatności Apple należy przesłać `transaction_id` przez `/api/v1/orders/{id}/apple-verify/`, aby zakończyć weryfikację po stronie serwera i przyznanie punktów. Liczba punktów pochodzi z pakietu; kwota używa niezależnej, wstępnie ustawionej ceny Apple w USD, bez nakładania rabatów członkowskich ani marż witryny, a kwota obciążenia w lokalnej walucie w innych regionach zależy od strony potwierdzenia Apple.

## Błędy i ponawianie prób

* Zamówienie nie jest `Pending`: zwraca `400`; nie twórz ponownie sesji płatności.
* Nie podano `pay_way`: zamówienia o kwocie niezerowej zwracają `400`.
* Wywołanie anonimowe użyło niedozwolonej metody lub zamówienia o zerowej cenie: zwraca `403`, zaloguj się i ponów próbę jako właściciel.
* Uwierzytelniony użytkownik nie jest właścicielem zamówienia: zwraca `403`.
* Kanał płatności nie powiódł się: nie przesyłaj ponownie bezmyślnie; najpierw sprawdź szczegóły zamówienia, a następnie ponów próbę po potwierdzeniu, że nadal ma status `Pending`.

## Powiązane interfejsy

* [Tworzenie zamówienia do doładowania](https://platform.acedata.cloud/documents/platform-order-create)
* [Pobieranie szczegółów zamówienia](https://platform.acedata.cloud/documents/platform-order-detail)
* [Odświeżanie statusu zamówienia](https://platform.acedata.cloud/documents/platform-order-refresh)


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