切换到 中文 / Switch to 中文

Endpoint

GET /api/v1/billing/callback/yipay and POST /api/v1/billing/callback/yipay

This endpoint is mainly for configuring the Yipay async notify URL. Normal developers do not need to call it directly.

Behavior

  • Verifies RSA signature on each notification.
  • Returns fail if verification fails.
  • If verified and trade_status=TRADE_SUCCESS, checks order amount and expiry.
  • Credits balance idempotently; duplicate notifications do not double credit.
  • Returns success on success.

Configuration

Set the async notify URL in the Yipay dashboard to:

https://api.h3hub.cn/api/v1/billing/callback/yipay

The tower also needs YIPAY_* environment variables and the platform public key.