Pending-Bestellung. Die Zahlungsaktion greift auf den Zahlungskanal zu und kann den Bestellstatus ändern; vor dem Aufruf müssen Bestell-ID, Betrag und Zahlungsmethode bestätigt werden.
API-Übersicht
Grenzen der anonymen Zahlung
Anonymer Zugriff ist für Szenarien vorgesehen, in denen nach dem Öffnen eines kopierten Zahlungslinks der Anmeldestatus verloren gegangen ist; ein langfristiger Account Token ist weder erforderlich noch sollte er mitgesendet werden. Anonyme Aufrufe:- erlauben nur serverseitig konfigurierte gehostete Weiterleitungs-Zahlungsmethoden;
- verwenden fest die Desktop-Zahlungsseite;
- können keine Bestellungen mit Nullpreis einlösen;
- unterliegen einer Ratenbegrenzung nach IP und einzelner Bestellung;
- geben eine minimale Bestellprojektion zurück, die weder Konto, Application noch interne metadata enthält.
Anfragebeispiele
pay_way verwendet die tatsächlich vom Bestellmodell unterstützten Werte, zum Beispiel WechatPay, AliPay, Stripe, Card, Airwallex, X402, PayPal, AppleIAP, Reward, BankTransfer. Nicht jeder Wert ist für anonyme Anfragen oder auf jeder Website verfügbar.
Antwortbeschreibung
Eine erfolgreiche Antwort ist das aktualisierte Bestellobjekt und stellt den Einstieg für den nächsten Schritt üblicherweise überpay_url bereit; verschiedene Zahlungsmethoden können außerdem in kontrollierten Feldern die Informationen zurückgeben, die der Client zur Fortsetzung der Zahlung benötigt. Anonyme Antworten verwenden eine minimale Feld-Whitelist, authentifizierte Eigentümer erhalten vollständige Details.
Verlassen Sie sich nicht auf alte Feldnamen wie payment_url, qr_code_url oder payment_method; der aktuelle Order-Vertrag verwendet pay_url und pay_way.
Banküberweisung
Angemeldete Privat- und Geschäftskonten können beideBankTransfer verwenden, ohne dass eine Unternehmensverifizierung erforderlich ist. Sowohl Überweisungen in inländischen RMB als auch internationale Überweisungen in USD erfordern einen Bestellbetrag von mindestens 300 USD; der zu zahlende RMB-Betrag richtet sich nach dem zum Zahlungszeitpunkt angezeigten Betrag.
Vor der Zahlung können Sie über GET /api/v1/orders/{order_id}/payment-options/ die für die aktuelle Bestellung verfügbaren Überweisungswege und Betragsschwellen abfragen. Banküberweisungen müssen nach der Anmeldung vom Bestellinhaber initiiert werden und unterliegen den Konfigurationen der Zahlungsempfangskanäle und dem Geltungsbereich des Tarifs; anonyme Anfragen können sie nicht verwenden.
iOS-In-App-Kauf
Angemeldete Bestellinhaber könnenpay_way: "AppleIAP" übergeben. Diese Anfrage aktualisiert die ausstehende Bestellung anhand von metadata.apple_price des ausgewählten Tarifs und entfernt Rabatte, löst keine Belastung aus, schreibt keine Credits gut und gibt auch keinen Zahlungslink zurück. Bei alten ausstehenden Bestellungen sollte zuerst dieser Schritt abgeschlossen werden, bevor die native Apple-Zahlung initiiert wird. Unterstützt wird nur ein Usage-Tarif mit einem konfigurierten Apple-Produkt und -Preis; nicht unterstützte Tarife oder Sammelbestellungen geben 400 zurück.
Nach der nativen Apple-Zahlung übermitteln Sie über /api/v1/orders/{id}/apple-verify/ die transaction_id, um die serverseitige Verifizierung und Credit-Gutschrift abzuschließen. Die Anzahl der Credits stammt aus dem Tarif; der Betrag verwendet den unabhängigen USD-Standardpreis von Apple, ohne Mitgliederrabatte oder Website-Aufschläge, und der Belastungsbetrag in lokaler Währung anderer Regionen richtet sich nach der Apple-Bestätigungsseite.
Fehler und Wiederholungen
- Die Bestellung ist nicht
Pending: Gibt400zurück; erstellen Sie keine Zahlungssitzung erneut. pay_waywurde nicht angegeben: Bestellungen mit Nicht-Null-Betrag geben400zurück.- Ein anonymer Aufruf verwendet eine nicht erlaubte Methode oder eine Bestellung mit Nullpreis: Gibt
403zurück; nach der Anmeldung sollte der Eigentümer es erneut versuchen. - Authentifiziert, aber nicht Bestellinhaber: Gibt
403zurück. - Zahlungskanal fehlgeschlagen: Nicht blind erneut absenden; fragen Sie zuerst die Bestelldetails ab und versuchen Sie es erst erneut, nachdem Sie bestätigt haben, dass sie weiterhin
Pendingist.

