PAYMENT-SIGNATURE, а потім повторює запит із тим самим запитом.
Відмінність полягає в тому, що оплата замовлення є API платформи й потребує токена облікового запису; тоді як прямий виклик AI API x402.acedata.cloud може використовувати лише X402 і не потребує API Token.
Підготовка замовлення
Перейдіть до консолі Ace Data Cloud, виберіть замовлення, яке потрібно оплатити, і запишіть ID замовлення. Якщо у вас ще немає замовлення, ви можете створити неоплачене замовлення на сторінці тарифів. Ціна замовлення визначається відображенням на сторінці, аamount у відповіді X402 402 є остаточною основою для підпису.
Створення токена облікового запису
Запит на оплату замовлення потребує токена облікового запису. Відкрийте сторінку Token платформи і створіть token у форматіplatform-v1-....
Для подальших запитів використовуйте:
Ініціювання 402
Спочатку надішліть запит безPAYMENT-SIGNATURE:
accepts:
x402Version дорівнює 2, network використовує ідентифікатор CAIP-2, а поле суми — amount.
Результат виконання програми зі створення замовлення на 10 Credits та ініціювання 402:
Наведені нижче записи транзакцій є історичними фактичними прикладами за старою політикою, суми та хеші транзакцій збережено без змін. Нові замовлення X402 більше не мають знижок за способом оплати; для підпису та оплати використовуйте amount у цій відповіді 402.
- Після успішного створення замовлення його статус —
Pending, на цей момент ще немає ончейн-оплати. - Перший запит
pay/не міститьPAYMENT-SIGNATURE, тому повертається HTTP 402. acceptsодночасно надає Baseexactі Solanaexact; у цьому посібнику надалі вибирається Base.- Ціна під час створення замовлення становила
1.26, а під час оплати за старою політикою знижок X402 фактична сума підпису та розрахунку становила1.2USDC, що відповідає1200000atomic USDC.
resource тут є полем, яке повертається сервером і бере участь у підписі; клієнт не повинен самостійно змінювати протокол, шлях або ID замовлення в ньому.
Підписання та повторна спроба
Для оплати замовлення можна повторно використовувати@acedatacloud/x402-client або низькорівневі функції підписання acedatacloud-x402. Нижче наведено приклад TypeScript:
exact:
status 200означає, що API оплати замовлення платформи прийняв цейPAYMENT-SIGNATURE.has_x_payment_response Trueозначає, що заголовок відповіді містить закодовану в Base64 квитанціюPAYMENT-RESPONSE.settle_header.success=Trueіnetwork=baseозначають, що Facilitator завершив settlement у Base.- Кінцевий статус замовлення —
Finished,pay_way—X402, а вpay_idзаписано хеш ончейн-транзакції. - Подія
Transferна BaseScan показує, що адреса платника переказала1200000atomic USDC на адресу отримання коштів платформи, тобто1.2USDC.
Успішна відповідь і квитанція
Після успішної оплати замовлення тіло відповіді містить інформацію про замовлення. Платформа також передає в заголовку відповідіPAYMENT-RESPONSE закодовану в Base64 settlement response, після декодування якої поширені поля включають:
Якщо вам потрібна звірка, рекомендується одночасно зберігати ID замовлення, адресу гаманця платника,
transaction і кінцевий статус замовлення.
Зауваження
- Для оплати замовлення потрібен токен облікового запису платформи, не можна завершити її лише за допомогою підпису X402-гаманця.
amountвикористовує USDC atomic units,1200000означає1.2USDC.- Не складайте адресу отримувача або адресу активу самостійно, орієнтуйтеся на
acceptsу відповіді 402. - Якщо той самий
PAYMENT-SIGNATUREбуде надіслано повторно, Facilitator застосує nonce для захисту від повторного відтворення.
Відповідь про помилку оплати
Перший HTTP 402 безPAYMENT-SIGNATURE є нормальним платіжним викликом і не означає помилку оплати. Помилки перевірки або settlement після підписання все ще зберігають стандартний рядковий error як сумісний резервний варіант, а в extensions.acedatacloud.paymentError повертається стабільна структура помилки:
code, а для невідомого code повертатися до загальної помилки оплати. charged — це тристанове поле: false повертається лише у разі явної відмови до settlement; відсутність поля означає, що статус списання невідомий, і її не можна тлумачити як «кошти не списано». Після переходу поточного замовлення в Failed його не можна повторити як те саме замовлення, будь ласка, виправте проблему з гаманцем і створіть нове замовлення.
metadata.x402.last_error і metadata.x402.errors у списку та деталях замовлень зберігають той самий набір code, stage, retryable, charged і params; публічний опис зберігається в reason, а час виникнення — у timestamp. Наприклад, insufficient_token_balance означає недостатній баланс USDC у вибраній мережі, а invalid_signature означає недійсний платіжний підпис; повторне отримання замовлення не змінить їх на загальний payment_failed.
Не записуйте та не надсилайте повний PAYMENT-SIGNATURE, підпис гаманця, authorization payload, необроблену діагностику Facilitator або RPC-відповідь. Для перевірки службою підтримки достатньо ID замовлення та публічного code помилки.
Викуп і спалювання ACE для платежів Base та Solana
Після увімкнення стратегії викупу 3% від фактично отриманої суми придатних платежів Circle USDC в основній мережі Base та USDC в основній мережі Solana використовується для купівлі й спалювання ACE, без додаткового списання з гаманця платника. Нарахування виконується один раз під час поповнення, а подальші виклики API з використанням цих Credits не нараховуються повторно; для історичних замовлень зі знижкою та замовлень зі старою стратегією нарахування не застосовується автоматично заднім числом. Платежі Base зберігають платіжну квитанцію в мережі Base, а купівля та спалювання ACE асинхронно виконуються в Solana. Для придатних платежів точно нараховується 3% від фактично отриманої суми, без фіксованого ліміту суми викупу на одну транзакцію або на день; доступні кошти, ринкові котирування та ончейн-підтвердження все ще можуть впливати на час завершення. Об’єктace_burn у деталях замовлення надає settlement_network, settlement_transaction і execution_network, а після завершення — swap_signature і burn_signature. Pending або Processing не означає, що спалювання вже відбулося; лише Completed означає, що остаточний ончейн-доказ було перевірено. Якщо платіж Base ще не досяг остаточного підтвердження, викуп чекатиме на підтвердження, але це не впливає на Credits, що вже надійшли.
