Pending-order. Betalningsåtgärden kommer att åtkomma betalningskanalen och kan ändra orderstatusen; före anropet måste order-ID, belopp och betalningsmetod bekräftas.
API-översikt
Gränser för anonym betalning
Anonym åtkomst används för scenarier där inloggningssessionen går förlorad efter att en kopierad betalningslänk har öppnats, och kräver inte och bör inte inkludera en långvarig Account Token. Anonyma anrop:- tillåter endast hanterade omdirigeringsbaserade betalningsmetoder som konfigurerats på servern;
- använder alltid betalningssidan för dator;
- kan inte hämta ordrar med nollpris;
- begränsas av IP och enskild order;
- returnerar en minimal orderprojektion, utan konto, Application eller intern metadata.
Exempel på begäran
pay_way använder verkliga värden som stöds av ordermodellen, till exempel WechatPay, AliPay, Stripe, Card, Airwallex, X402, PayPal, AppleIAP, Reward, BankTransfer. Inte alla värden är tillgängliga för anonyma begäranden eller på varje webbplats.
Svarsbeskrivning
Ett lyckat svar är det uppdaterade orderobjektet, som vanligtvis tillhandahåller nästa steg viapay_url; olika betalningsmetoder kan även returnera information i kontrollerade fält som klienten behöver för att fortsätta betalningen. Anonyma svar använder en minimal vitlista med fält, medan autentiserade ägare får fullständig information.
Förlita dig inte på gamla fältnamn som payment_url, qr_code_url eller payment_method; det aktuella Order-kontraktet använder pay_url och pay_way.
Banköverföring
Inloggade privata konton och företagskonton kan båda användaBankTransfer, utan företagsverifiering. Både inhemska RMB-överföringar och internationella USD-överföringar kräver att orderbeloppet är minst 300 USD; det RMB-belopp som ska betalas baseras på det belopp som visas vid betalningstillfället.
Före betalning kan du fråga efter tillgängliga överföringsrutter och beloppströsklar för den aktuella ordern via GET /api/v1/orders/{order_id}/payment-options/. Banköverföringar måste initieras av orderägaren efter inloggning och begränsas av konfigurationen för mottagningskanalen och paketets tillämpningsområde; anonyma begäranden kan inte använda dem.
iOS-köp i appen
Den inloggade orderägaren kan angepay_way: "AppleIAP". Denna begäran uppdaterar den obetalda ordern enligt det valda paketets metadata.apple_price och tar bort rabatten, utan att skapa någon debitering, utfärda krediter eller returnera en betalningslänk. Äldre obetalda ordrar ska först slutföra detta steg och sedan initiera Apples inbyggda betalning. Endast ett Usage-paket med en konfigurerad Apple-produkt och ett pris stöds; paket som inte stöds eller batchordrar returnerar 400.
Efter Apples inbyggda betalning skickas transaction_id via /api/v1/orders/{id}/apple-verify/ för att slutföra serververifiering och utfärdande av krediter. Antalet krediter kommer från paketet; beloppet använder Apples separata förinställda USD-pris, utan medlemsrabatter eller webbplatsprispåslag, och det lokala debiteringsbeloppet i andra regioner baseras på Apples bekräftelsesida.
Fel och återförsök
- Ordern är inte
Pending: returnerar400; skapa inte betalningssessionen igen. pay_wayhar inte angetts: ordrar med belopp som inte är noll returnerar400.- Ett anonymt anrop använder en otillåten metod eller en order med nollpris: returnerar
403, försök igen efter inloggning som ägaren. - Autentiserad men inte orderägaren: returnerar
403. - Betalningskanalen misslyckas: skicka inte in upprepade gånger utan eftertanke; fråga först efter orderdetaljerna och försök igen efter att ha bekräftat att den fortfarande är
Pending.

