Help Center
VCCHUB How-to
  1. API Reference
  • Guides
    • Welcome
    • Interface
  • API Reference
    • Introduction
    • Endpoints
    • Data Types
    • Signing
    • 3-D Secure Verification
    • Subscription
    • Errors
    • Webhooks
    • Items Information
    • Changelog
    • Acquiring
      • Create a direct payment
        POST
      • Create a APM payment
        POST
      • Create a redirect (iFrame) payment
        POST
      • Query a transaction
        POST
      • Capture a transaction
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Cancel a subscription
        POST
      • Refund a transaction
        POST
      • Search a refund transaction
        POST
      • Create a payout
        POST
      • Optimise payment methods
        POST
      • Batch Upload Logistics Information
        POST
      • Query a payout transaction
        POST
      • Query Merchant Payout Balance
        POST
      • Query Merchant Unsettled Amount
        POST
    • Issuing
      • Cardholder
        • Create cardholder
        • Update Cardholder
        • Delete cardholder
        • Query cardholder
      • Group
        • Create group
        • Query group details
        • Delete group
        • Group Card Withdrawal
        • Update group status
        • Recharge group
        • Query rule
      • Card
        • Create a card
        • Query card details
        • Query card transaction
        • Cancel a card
        • Withdraw from a card
        • Update card status
        • Recharge card
        • Update shared card limit
        • Query for card operation
        • Query card BIN
      • Account
        • Query Account Balance
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. API Reference

Changelog

Below is a list of backwards-incompatible changes to the Star SaaS API.
To prevent disruptions to existing integrations, all such changes are managed through versioning. For more information, refer to the previous section.
This list highlights the affected endpoints to help you identify any necessary migration efforts. For full details on each endpoint's updated specifications, please consult the relevant version's documentation.
If you have any questions or concerns, feel free to contact our support team.

2021-06-01#

First Version.

2021-11-29#

direct credit card add two request parameters:
challenge_window_size String, Length: 2
session_id String Length: 50

2021-12-13#

Add staging

2022-3-14#

Add notes

2025-1-20#

Add following parameters in Create a direct payment and Create a redirect payment request
color_depth
accept
user_agent
Add following subscriptions parameters in Create a direct payment
"subscription": {
"contract": "string",
"contract_name": "string",
"interval": "day",
"interval_count": "string",
"billing_cycle": 0,
"contract_start": "string",
"contract_end": "string",
"price_id": "string"
}
Add following parameters in Query response
antifraud_provider
is3ds
"fraud_check_result": {
"check_items": "Approved By Forter",
"status": "ACCEPT"
}

2025-03-25#

Add pages:
1.
3-D Secure Verification
2.
Subscription
3.
Add Cancel a subscription endpoint
Modified:
1.
Items Information page
2.
Add subscription objects in direct and redirect

2025-08-22#

VCCHUB API Docs
1.
Update for 3.2 Query Card Details
a. Added new parameter result.enable_apple_payto Response Parameters

2025-09-25#

VCCHUB API Docs
1.
Update for 3.10 Query Card BIN
a. Added new parameter result.card_scenario, result.card_platform to Response Parameters.

2025-10-16#

VCCHUB API Docs
1.
Update for 3.9 Query for Card Singular Operation Order
a. request_id is supplemented as a new parameter to the query request;
i. the return logic is adjusted accordingly — if request_id is passed together with order_id, they must match the same transaction to return a successful result; if only one of the two parameters (request_id or order_id) is passed, the transaction will be returned as long as it can be retrieved via that single parameter.
b. card_idis added to the return result of this interface.

2025-11-14#

VCCHUB API Docs
1.
New interface added for updating cardholders unused for card creation.

2025-11-20#

[Acquiring]Added the platform_source field in the Query API response.

2025-12-05#

[Acquiring]Updated Items Information to support item category details. Added ,# Item1-Category# at the end of the item information format.

2026-01-21#

[Issuing] Updated 4.1 Query Account Balance API to support real-time balance inquiries.
[Acquiring] Added Payout Webhooks. Payout status notifications are now delivered to the merchant-defined notify_url using the NameValuePair format.

2026-02-04#

[Acquiring] Added the Payout Transaction Query API to support payout transaction status and detail inquiries.

2026-03-02#

[Acquiring] Added APIs for querying Payout Balance and Merchant Pending Settlement Amount.

2026-05-20#

[Acquiring] Added the Batch Upload Logistics Information API.

2026-06-11#

[Issuing] Added four new transaction types to records.transaction_type.

2026-07-22#

[Issuing] Updated the enumeration values of the card_status field in the Query Card Details API response.

2026-07-31#

[Acquiring] Enhanced the Direct Payment API by introducing the new request parameter secure_payment. The upgraded API supports both legacy and secure card data transmission modes:
Legacy Mode: Existing integration mode. Card details, including card number, expiration date, and CVV, are transmitted directly as plaintext.
Secure Mode: New RSA-based encryption mode. Card data is encrypted using the RSA public key before transmission for enhanced security.
Previous
Items Information
Next
Create a direct payment