Уведомление о колбэке

ПОДСКАЗКА (TIP)

После завершения платежа платежный центр отправит соответствующие результаты платежа и соответствующую информацию продавцу, а продавцу необходимо получить обработку и вернуть ответ. При взаимодействии с фоновыми уведомлениями, если платежный центр получает от продавца ответ, который не успешен или время ожидания которого истекло, платежный центр считает, что уведомление не удалось. Уведомление будет периодически инициироваться заново в соответствии с определенной политикой, чтобы максимизировать вероятность успеха уведомления, но нет гарантии, что уведомление будет успешным. (Частота уведомлений составляет 0с/15с/30с/3м/10м/20м/30м/60м/3ч/6ч)

ПРЕДУПРЕЖДЕНИЕ (WARNING)

Примечание: Одно и то же уведомление может быть отправлено в систему продавца несколько раз. И система продавца должна уметь правильно обрабатывать одно и то же уведомление. Рекомендуемые практики таковы. При обработке уведомления сначала проверяется статус соответствующих бизнес-данных, чтобы определить, было ли обработано уведомление. Если нет, обработайте его снова. Если да, сразу верните успешный результат. Перед проверкой состояния и обработкой бизнес-данных выполняется управление параллелизмом с использованием блокировок данных, чтобы избежать хаоса данных, вызванного повторным входом в функции.

ОПАСНОСТЬ (DANGER)

Внимание: Система продавца должна выполнить проверку подписи для содержимого колбэка заказа и убедиться, что возвращенная сумма заказа совпадает с суммой заказа. Причина этого заключается в предотвращении утечки данных, приводящей к «ложному уведомлению», что влечет за собой потерю средств.

Адрес интерфейса (Interface address)

Установлен параметр notify_url, отправленный через интерфейс единого заказа POST. Если вы не можете перейти по ссылке, ваша сервисная система не сможет получать уведомления из платежного центра.

Request Body

Имя	Тип	Описание	Описание
app_id	string	Приложение
mch_id	string	Продавец
create_time	time	Время уведомления
resource_type	string	Тип данных ресурса уведомления. Уведомление об успешном платеже — encrypt-resource
event_type	string	Тип уведомления. Тип уведомления об успешном платеже — SUCCESS.
resource	object	Данные ресурса уведомления
» original_type	string	Исходный тип обратного вызова — transaction
» algorithm	string	В настоящее время для алгоритма шифрования, который шифрует данные результата, поддерживается только AES-256-ECB
» ciphertext	string	Зашифрованный текст данных результатов включения/выключения, закодированный в Base64. Если этот параметр включен, возвращается зашифрованный контент. После расшифровки это строка JSON объекта TransactionNotifyDetail.
» nonce	string	Шифрование с использованием случайных строк

Пример запроса (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"
	}
}

Пример возврата (Return example)

success

Пожалуйста, верните success, чтобы уведомить сервер уведомлений после успешного получения запроса на обратный вызов. После того как сервер уведомлений получит success, отправка уведомлений прекращается. В противном случае уведомление будет отправлено 10 раз с частотой 0с/15с/30с/3м/10м/20m/30м/60м/3ч/6ч.