1. API Reference
API
  • 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
      • Refund a transaction
        POST
      • Search a refund transaction
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Cancel a subscription
        POST
      • Capture a 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
  • 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 Xnova 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-11-20#

Added the platform_source field in the Query API response.

2025-12-05#

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

2026-01-21#

Added Payout Webhooks. Payout status notifications are now delivered to the merchant-defined notify_url using the NameValuePair format.

2026-02-04#

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

2026-03-02#

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

2026-05-20#

Added the Batch Upload Logistics Information API.

2026-07-31#

Enhanced the Direct Payment API to support RSA-encrypted card data transmission. Added the new request parameter secure_payment for transmitting encrypted card details. The card field now requires a masked card number in the format of the first 8 digits + **** + last 4 digits, while expiration_year, expiration_month, and security_code have been removed from the request parameters. The encryption_data signature rule has also been updated to exclude card-related fields.
Modified at 2026-11-02 07:54:44
Previous
Items Information
Next
Create a direct payment