1688 KJB (Cross-border Pay) payment link API
تستخدم التكاملات الجديدة الشراء والتنفيذ المدارين بواسطة HIOBuy. يقتصر الشراء الذاتي وSelf Fulfillment وOAuth الشخصي على التطبيقات الحالية المصرح لها إدارياً ذات الاشتراك الساري. لا تتوفر الصلاحيات المنتهية أو المعطّلة؛ راجع الدعم بخصوص الاتفاق الحالي. تبقى نقاط النهاية وسجلات الطلبات محفوظة. بعد انتهاء الاشتراك القديم لا يعيد تجديده تفعيل الوضع السابق.
هذه الصفحة الجديدة متاحة حاليًا باللغة الإنجليزية.
Generate a payment link specifically for 1688 KJB (Cross-border Pay), not a general-purpose payment link for other payment methods. The returned pay_url opens the 1688 cashier for eligible KJB orders. This API does not charge an account, confirm payment, update a procurement order, or record GMV. Only 1688 is supported.
Activate 1688 KJB (Cross-border Pay)
Before paying with KJB, activate Cross-border Pay in WorldFirst and bind/authorize the 1688 buyer account used for these orders. HioBuy API authorization does not activate KJB for you. Follow the WorldFirst official English activation and usage guide .
After opening the returned cashier link, select Secured transaction → Cross-border Pay (KJB) to complete payment with the bound WorldFirst account. Link generation does not guarantee KJB is available for every order; account activation and order eligibility still apply. Eligibility, fees, and supported regions are subject to WorldFirst and 1688’s current rules.
Request
Use POST /v1/orders/payment-link with channel: "1688", or POST /v1/orders/1688/payment-link with an optional channel that must be 1688 when supplied.
Requires a live key with order:create scope, plan access to 1688, and valid 1688 buyer authorization. The Gateway handles marketplace signing and access tokens. Successful requests cost 2 shared daily billable units per request, not per order.
POST https://api.hiobuy.com/v1/orders/payment-link
Authorization: Bearer <hio_live_API_KEY>
Content-Type: application/json
{"channel":"1688","order_ids":["151923545498520","151923545498521"]}In both fulfillment modes, this API calls 1688 directly with the app/mode’s selected buyer token. It cannot replace warehouse procurement payment or update warehouse order status.
Standard response
{
"channel": "1688",
"payment_method": "cross_border_pay",
"success": true,
"pay_url": "https://trade.1688.com/order/cashier.htm?orderId=151923545498520",
"cant_pay_order_ids": [
"151923545498521"
],
"request_id": "req_example"
}success means link generation only. Excluded orders are listed in cant_pay_order_ids; a returned link does not imply every requested order can be paid. An explicit upstream rejection returns HTTP 200 with success: false, pay_url: null, and optional error_code / error_message. Upstream 400_4 means no requested order can use Cross-border Pay.
Standard mode accepts only HTTPS URLs on 1688.com or its subdomains, without URL credentials or nonstandard ports. Missing or unsafe links and malformed upstream results produce HTTP 502 CHANNEL_UPSTREAM_ERROR.
التكاملات الحالية
Set response_format: "upstream" for the vendor envelope. upstream_api is com.alibaba.trade/alibaba.crossBorderPay.url.get. Unsafe Long integers are preserved as exact strings; otherwise vendor fields remain unchanged. Raw mode does not validate standard business results or cashier URLs, so consumers must validate them themselves.
Invalid input returns HTTP 400 VALIDATION_ERROR; non-1688 channels return UNSUPPORTED_CHANNEL. Standard API authentication, scope, plan, and rate-limit errors also apply.
There is no payment Idempotency-Key replay on this link-generation API: each valid request retrieves a fresh link. Do not apply this retry behavior to actual payment submission. Do not log full cashier URLs. Link expiry is unspecified; confirm actual payment through the applicable order status query after checkout.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days