Callback-Benachrichtigung

TIPP (TIP)

Nachdem die Zahlung abgeschlossen ist, sendet das Zahlungszentrum die entsprechenden Zahlungsergebnisse und relevanten Informationen an den Händler. Der Händler muss die Verarbeitung empfangen und die Antwort zurückgeben. Bei der Interaktion mit Hintergrundbenachrichtigungen geht das Zahlungszentrum davon aus, dass die Benachrichtigung fehlgeschlagen ist, wenn es eine Händlerantwort erhält, die nicht erfolgreich ist oder abläuft. Die Benachrichtigung wird gemäß einer bestimmten Richtlinie regelmäßig neu initiiert, um die Erfolgsrate der Benachrichtigung zu maximieren. Es gibt jedoch keine Garantie dafür, dass die Benachrichtigung erfolgreich ist. (Die Benachrichtigungshäufigkeit beträgt 0s/15s/30s/3m/10m/20m/30m/60m/3h/6h)

WARNUNG (WARNING)

Hinweis: Dieselbe Benachrichtigung kann mehrmals an das Händlersystem gesendet werden. Das Händlersystem muss in der Lage sein, dieselbe Benachrichtigung korrekt zu verarbeiten. Empfohlene Vorgehensweisen sind wie folgt. Bei der Verarbeitung einer Benachrichtigung wird zunächst der Status der entsprechenden Geschäftsdaten überprüft, um festzustellen, ob die Benachrichtigung verarbeitet wurde. Wenn nein, verarbeiten Sie sie erneut. Wenn ja, geben Sie direkt ein Erfolgsergebnis zurück. Vor der Statusüberprüfung und der Verarbeitung von Geschäftsdaten wird die Parallelitätskontrolle mithilfe von Datensperren durchgeführt, um Datenchaos durch Wiedereintritt in Funktionen zu vermeiden.

GEFAHR (DANGER)

Achtung: Das Händlersystem muss eine Signaturüberprüfung für den Inhalt des Bestell-Callbacks durchführen und überprüfen, ob der zurückgegebene Bestellbetrag mit dem Bestellbetrag übereinstimmt. Der Grund dafür ist, Datenlecks zu verhindern, die zu „falschen Benachrichtigungen“ führen, was wiederum zu finanziellen Verlusten führt.

Schnittstellenadresse (Interface address)

Der vom POST-Unified-Order-Interface übermittelte Parameter notify_url wird festgelegt. Wenn Sie nicht auf den Link zugreifen können, kann Ihr Servicesystem die Benachrichtigung vom Zahlungszentrum nicht empfangen.

Request Body

Name	Typ	Beschreibung	Beschreibung
app_id	string	Anwendung
mch_id	string	Händler
create_time	time	Benachrichtigungszeit
resource_type	string	Der Ressourcendatentyp der Benachrichtigung. Erfolgreiche Zahlungsbenachrichtigung ist encrypt-resource
event_type	string	Benachrichtigungstyp. Der Typ der erfolgreichen Zahlungsbenachrichtigung ist SUCCESS.
resource	object	Ressourcendaten der Benachrichtigung
» original_type	string	Der ursprüngliche Callback-Typ ist transaction
» algorithm	string	Derzeit wird nur AES-256-ECB für den Verschlüsselungsalgorithmus unterstützt, der die Ergebnisdaten verschlüsselt
» ciphertext	string	Base64-kodierter Ein-/Aus-Ergebnisdaten-Geheimtext. Wenn aktiviert, wird der verschlüsselte Inhalt zurückgegeben. Nach der Entschlüsselung handelt es sich um einen JSON-String von TransactionNotifyDetail.
» nonce	string	Mit zufälligen Zeichenfolgen verschlüsseln

Anfragebeispiel (Request example)

{
	"app_id": "xxxxx",
	"mch_id": "zzzzzz",
	"create_time": "2023-06-26T17:21:17.754429+08:00",
	"resource_type": "encrypt-resource",
	"event_type": "TRANSACTION.SUCCESS",
	"resource": {
		"original_type": "transaction",
		"algorithm": "AEAD_AES_256_GCM",
		"ciphertext": "I/psKgdkVwxbkEIWtwRxfxLzViuRS+gJTQSdLf+lmK7awoqUcIJisTAJx0Qbv4K6wV8WgyMRFYHD5CCLKmFNU2OnmEm2f2vGhaoS2h28A9BEGx1CWEUw3tfldf/+VWlBAnIBylFjHzbSo7fgn7S3fFEAZHTxoy+9jNIoynqHZbn4Y6eucj1YCw0ZmuKHPpPPrvclbhHmaZHfau+SKyag3C0/cj7zu4mBkRZ39zuk9B7DAADzaRENOZ/ZyibU+zs3gibnCbI2NWEnQWIiCi7vK0jq/FCBWytHihQM364zlVrPPCBDbv2MSqk4fyAM7IDeT6h/z/2kmDOQ6aFPYlLojIkgCCOIevQITS9E+BS1rgmmH+DRKsJNiD257aLhX2/F53VEnjfqqKdDs2lqfX0dCMLqselGUT981fFKceXg+r6hQqcUzLlF28XL5NrfVPreRDo6jI2K0tCy9cOx+cxH3yoDzOFBzM0RlxWqvUhRsMv9ZGfpgCZ0o9HxNObqLjVCQzE5SWPXvmkw+QpWk0oNUvpCEDhj9Vfq6XCV8j3tT3tZTYCa5UQy9VCdmval/2vb50QaAgDYXU6PH/9Xv7AXg6kg29iK+Ec0euxZxosRoVczzRg+0Arl/zvBcphWNIUTdx5IcA12WtP+krk9NNGtj7igk21DhcseJrKBpG7ll9O/Wmq1L8BwW+ypuJS+kHV61jRNYMFJY48Pt11Zoukgqu94kzrhz+KET8q463zlyu/Kp2z5yWI8xwvOtuyjosszfm6/YFQTFdhcmHY3X1yz44NaVG9FPev1QPoPmI7K3Jqa0Q8Q5kQTbe/KrB0eyRpXtyAaShOEeiS2ypmFAC81/m4mjuTd24yAjBcTIfBYzjxwjPbKfv+OYKahDwJP1b7EhsM+Sgu48wQ+pp6wc8TYCOkiRR1pKeb3kaxpQGzlq7VNbWHFPw9TDiyCIEnr8T5eiJtzJJ0U0iIfqN5WHk7iHiNK4Y4TvmdF4f6UyeMTHvaprvzUZI8il5wvoCgIiRUY7qvv5V/KL4ZWHN6Y3EEvQmP4WDo3Wx5IFW8C1gkyFv8lQ1COSNYMPog6RLAI0rNvKZjvc4baWwcHmk/fM92X19F2Y0DArqLFFUTJVE5bUQXQexiUO1e8IL07wqY=",
		"nonce": "d8816e8d6dca4409b790a4bcaa25c621"
	}
}

Rückgabebeispiel (Return example)

success

Bitte geben Sie success zurück, um den Benachrichtigungsserver zu benachrichtigen, nachdem die Callback-Anfrage erfolgreich empfangen wurde. Nachdem der Benachrichtigungsserver success empfangen hat, stoppt die Benachrichtigung. Andernfalls wird die Benachrichtigung 10 Mal in der Häufigkeit 0s/15s/30s/3m/10m/20m/30m/60m/3h/6h gesendet.