Skip to main content

API Documentation Introduction

Welcome to the VP API documentation. This documentation provides complete API specifications for two wallet modes.

👉 Seamless Wallet: View Documentation
👉 Transfer Wallet: View Documentation

General Notes​

Security Requirements​

  1. HTTPS Required

    • All API requests must use HTTPS protocol
    • Ensure SSL certificate is valid and not expired

  2. Encrypted Transmission

    • Sensitive data must use AES-256-GCM encryption
    • Keep encryption keys secure and avoid leakage

  3. Signature Verification

    • Each request must include a valid signature
    • Use SHA256 algorithm for signature verification

  4. Token Management

    • JWT Token is valid for 24 hours
    • Token must be reacquired after expiration
    • Do not pass Token in URL

Request Specification​

  1. Request Header Settings

    Content-Type: application/json
    Authorization: Bearer {token}

  2. Character Encoding

    • Always use UTF-8 encoding
    • Special characters must be URL encoded

  3. Time Zone Settings

    • All time parameters use UTC+0 time zone
    • Except for x-timestamp in the header which uses milliseconds Unix timestamp, other API time formats must use the ISO 8601 standard's YYYY-MM-DDTHH:mm:ss.SSSZ format (e.g., 2026-02-02T10:30:00.000Z)

Error Handling​

  1. Idempotency

    • Use unique "Transaction ID" and "Bet ID" to ensure idempotency
    • Duplicate requests will not result in duplicate deductions

  2. Error Codes

    • For detailed error codes, please refer to the error Appendix of each wallet mode.
    • Seamless Wallet: Error Appendix
    • Transfer Wallet: Error Appendix

Test Environment​

1. Test Account

  • Please Contact Customer Support Team to obtain a test environment account.
  • The test environment is completely isolated from the production environment.
  1. Test Key
  • The testing environment uses a separate API key
  • This must be replaced with the production environment key before going live
  1. Test Data
  • Data in the test environment will not be synchronized to the production environment.

Technical Support​

If you encounter any problems during the implementation process, please Contact Customer Support Team.

Quick Start​

  1. Choose Wallet Mode - Choose Seamless Wallet or Transfer Wallet based on business requirements
  2. Get API Key - Contact Customer Support Team to get the test environment key
  3. Read Documentation - Carefully read the API Documentation for the corresponding wallet mode
  4. Test Integration - Complete API integration in the test environment
  5. Go Live Deployment - Apply for the production environment and then deploy to production

Last updated: 2026-02-02