Linksfield Developer
OverviewCube APIsTopup APIs
Old version
OverviewCube APIsTopup APIs
Old version
  1. Topup APIs
  • Mall Global Specification
  • Mall Business Flow
  • Mall API Signature Code Examples
  • APP Integration with Stripe SDK — Example Notes
  • Vshop
    • Card Login Verification
      POST
    • Get Available Data Plan Product List
      POST
    • Create User Order
      POST
    • Query Active and Pending Orders
      POST
    • Get Active Auto-Renewal
      POST
    • Cancel Auto-Renewal
      POST
    • Create User Order (Third-Party Payment)
      POST
  • Payment
    • Get Stripe Single Payment Authorization
      POST
    • Get Stripe Subscription Payment Authorization
      POST
    • Create Stripe Subscription / Auto-Renewal
      POST
    • Query Payment Result
      POST
    • Confirm Payment Result
      POST
  • Notification
    • Recharge Success Message Push
      POST
  • Bundle-groups
    • Add SIM Cards to a Specified Group
      POST
    • Remove SIM Cards from a Specified Group
      DELETE
    • Query SIM Card Numbers in a Specified Group
      GET
    • Query All Groups and Basic Data Plan Information
      GET
    • Retrieve Asynchronous Operation Result
      GET
  • Order
    • Query Order Details
      GET
  1. Topup APIs

Mall Business Flow

Single Purchase Business Flow#

Overview#

This flow applies to users holding a Linksfield SIM card who initiate a purchase of a standard data plan. Upon successful payment, the user gains access to the corresponding period of communication service. Once the service period expires, communication is suspended and the user must initiate a new purchase.

Flow Steps#

StepDescriptionAPINotes
Step 1User enters SIM card ICCID; system performs validity verification/singleVerify
Step 2SIM card verified; retrieve the list of available data plans for the SIM/singleServicePlanPage
Step 3User selects a plan and places an order; system creates the order/singleOrder
Step 4System obtains Stripe one-time payment authorization/stripePayStripe is invoked by the APP/H5 frontend
Step 5Query payment result/resultQuery
Step 6Confirm payment result/resultConfirm
Step 7Purchase successful; user queries active and pending orders/singleQueryOrder

Auto-Subscription (Auto-Renewal) Purchase Business Flow#

Overview#

This flow applies to users holding a Linksfield SIM card who initiate a purchase of a data plan that supports auto-renewal. Upon successful payment, the user gains access to the corresponding period of communication service. At the same time, the user's payment card is registered with Stripe to create a recurring billing subscription. Stripe will automatically charge the card after each billing cycle, and upon a successful charge, the system will automatically extend the communication service for the corresponding period. If a charge fails due to user-related reasons (e.g., insufficient funds, card expired), the user risks having their communication service suspended. For common reasons for auto-charge failures, refer to the Stripe documentation: Decline Codes.

Flow Steps#

StepDescriptionAPINotes
Step 1User enters SIM card ICCID; system performs validity verification/singleVerify
Step 2SIM card verified; retrieve the list of available data plans for the SIM/singleServicePlanPage
Step 3User selects a plan and places an order; system creates the order/singleOrder
Step 4System obtains Stripe auto-renewal payment authorization/stripeAutoPayStripe is invoked by the APP/H5 frontend
Step 5System creates a Stripe subscription/stripeSubDirectlyStripe is invoked by the APP/H5 frontend
Step 6Query payment result/resultQuery
Step 7Confirm payment result/resultConfirm
Step 8Purchase successful; user queries active and pending orders/singleQueryOrder
Step 9Auto-renewal successfully created; user views active auto-renewal records/queryAutoRenewalRecord
Step 10User cancels auto-renewal/cancelAutoRenewalRecord
Modified at 2026-06-25 02:19:43
Previous
Mall Global Specification
Next
Mall API Signature Code Examples
Built with