Youidian HTTP API Docs

Use this track when you want a server-to-server integration instead of the SDK.

Best fit

Use the HTTP track when your backend should:

• create payment orders
• query payment status after the user completes checkout
• verify login tokens before creating a local session
• process payment callbacks and update your own business state

Base URL rule

When you need a full request URL, use:

YOUIDIAN_API_URL + route path

Core endpoints

• ${YOUIDIAN_API_URL}/api/v1/pay/orders
• ${YOUIDIAN_API_URL}/api/v1/pay/orders/:id?appId=...
• ${YOUIDIAN_API_URL}/api/v1/login/attempts
• ${YOUIDIAN_API_URL}/api/v1/login/attempts/:attemptId
• ${YOUIDIAN_API_URL}/api/v1/login/tokens/verify
• provider callback endpoints such as ${YOUIDIAN_API_URL}/api/v1/pay/notify/STRIPE and ${YOUIDIAN_API_URL}/api/v1/pay/notify/PAYPAL

Recommended flow

Your backend
  -> POST ${YOUIDIAN_API_URL}/api/v1/pay/orders
  -> store orderId from the response
  -> return paymentUrl / qrCode / mobileUrl to the frontend
  -> after the user pays, GET ${YOUIDIAN_API_URL}/api/v1/pay/orders/:id?appId=...
  -> grant access only after the order is confirmed

Your frontend
  -> start hosted login or a provider payment flow
  -> send the resulting login token or payment result to your backend
  -> let your backend verify the token or order status

Reading order

1. Installation
2. Authentication & Request Rules
3. Payment Orders
4. Login Integration
5. Advanced Integration
6. Payment Channel Reference
7. WeChat Mini Program Integration
8. Webhook Callbacks
9. Checklist