Zum Hauptinhalt springen
Erstellen oder aktualisieren Sie eine Zahlungssitzung für eine 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.
Authentifizierte Aufrufer müssen der Bestellinhaber oder ein Superadministrator sein. Methoden wie X402 und Prämieneinlösung, die einen Benutzerkontext erfordern, können nicht anonym aufgerufen werden.

Anfragebeispiele

Zahlungsmethoden, die eine Authentifizierung erfordern:
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 über pay_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 beide BankTransfer 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önnen pay_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: Gibt 400 zurück; erstellen Sie keine Zahlungssitzung erneut.
  • pay_way wurde nicht angegeben: Bestellungen mit Nicht-Null-Betrag geben 400 zurück.
  • Ein anonymer Aufruf verwendet eine nicht erlaubte Methode oder eine Bestellung mit Nullpreis: Gibt 403 zurück; nach der Anmeldung sollte der Eigentümer es erneut versuchen.
  • Authentifiziert, aber nicht Bestellinhaber: Gibt 403 zurü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 Pending ist.

Verwandte APIs