1. Basic Conventions
EurewaX Open API
  • Basic Conventions
    • Global Conventions
    • Message Structure
    • Signature
    • Encryption
  • Interaction Flow
    • Business Application Flow
  • Business APIs
    • 1 Common Services
      • 1.1 Event Notifications
        • Configure NotificationURL
      • 1.2 File Service
        • Upload File
        • supplementary business Document
      • 1.3 Authentication Service
        • Get Merchant Token
    • 2 Onboarding Services
      • 2.1 Merchant Onboarding
        • Register Merchant
        • KYCApply for
        • KYBApply for
        • Query KYCReview Result
        • KYCReview ResultNotification
        • Query KYBReview Result
        • KYBReview ResultNotification
        • Get can open through Product List
    • 3 Fiat Services
      • 3.1 Collection Services
        • 3.1.1 Collection Store Management
          • Get Platform Site
          • Add Store Owner
          • Bind Store
          • Query Store Information
        • 3.1.2 VA Account Services
          • Apply for VAAccount Number
          • Download Account OpeningCertificate
          • Query VAAccount Number
          • VAAccount NumberChange Notification
        • 3.1.3 Collection Transaction Processing
          • Collection Crediting Notification
      • 3.2 Payment Services
        • 3.2.1 Payee Management
          • Add Payee
          • Delete Payee
          • Query Payee Review Result
          • Payee Review ResultNotification
        • 3.2.2 Payment Transaction Processing
          • Single Payment
          • Payment ResultNotification
        • 3.2.3 Settlement Quota Management
          • Query FX Settlement Quota
          • Upload FX Settlement Document
          • Query FX Settlement Document Review Result
          • FX Settlement Document Review ResultNotification
      • 3.3 Foreign Exchange Services
        • Query Merchant Exchange Rate
        • Merchant FX Quote
        • Real-time FX
      • 3.4 Account Services
        • 3.4.1 Account Management
          • Account Query
          • Account Authorization
          • Cancel authorization
        • 3.4.2 Account Transactions
          • Account Transfer
          • Batch Transfer
          • Funds Pooling
          • Funds PoolingResultNotification
          • Batch TransferResultNotification
          • Per-transaction TransferResultNotification
      • 3.5 Transaction Queries
        • 3.5.1 Transaction Details
          • Funds PoolingTransaction Details
          • Payment Transaction Details
          • Collection Transaction Details
          • TransferTransaction Details
          • FX Exchange Transaction Details
        • Download Transaction Certificate
        • Query Transaction Details
    • 4 Crypto Services
      • 4.1 Basic Functions
        • Query Exchange Rate
        • Query Supported of asset
      • 4.2 Account Management
        • Query Account List
      • 4.3 Collection Instrument Management
        • Query Collection Instrument
      • 4.4 Payee Management
        • Add Payee
        • Delete Payee
        • Query Payee List
        • Payee Review ResultNotification
      • 4.5 Transaction Management
        • Fiat Deposit
          • Fiat Deposit
        • Fiat Withdrawal
          • Fiat Withdrawal
        • Crypto Deposit
          • Crypto Deposit
        • Crypto Withdrawal
          • Crypto Withdrawal
        • Crypto Buy
          • Get Crypto Buy Quote
          • Buy Crypto
        • Crypto Sell
          • Get Crypto Sell Quote
          • Sell Crypto
        • Fiat convert Crypto
          • Get fiat-to-cryptoQuote
          • Fiat convert Crypto
        • Crypto convert Fiat
          • Get crypto-to-fiatQuote
          • Crypto convert Fiat
        • Deposit/WithdrawalTransaction Fee estimate
        • Query Transaction Details
        • Query Transaction record
        • Transaction ResultNotification
    • 5 VCC Services
      • 5.1 Card Application Services
        • Query Product List
        • Virtual Card Apply for
        • Query Apply for Details
        • Card Apply for ResultNotification
      • 5.2 Card Information Query Services
        • Query Card CVV
        • Query Card Information
        • Query Card Balance
      • 5.3 Card Management Services
        • Unfreeze Card
        • Activate Card
        • Cancel Card
        • Freeze Card
        • Update Card Limit
        • Update Cardholder
        • Card StatusChange Notification
      • 5.4 Card Transaction Services
        • Funds Transfer In
        • Funds Transfer Out
        • Query non-authorization Transaction Details
        • Query Transaction List
        • Query Card Funds Details
        • Card Transaction ResultNotification
        • Card 3DSVerificationNotification
    • 6 Unified Checkout
      • Create Order
      • Query Order Details
      • Payment ResultNotification
  • Integration Testing
    • Overall Flow
    • Environment Parameters
  • Appendix
    • Enum Type
    • KYCtemplate
    • KYBtemplate
  • Schemas
    • TransferOrder
  1. Basic Conventions

Signature

1. standard through API#

1.1. Partner process the requestSignature#

Partner Required use if below of Informationproduce request Signature string, according to if below Data item concatenate in order, then Use Partner use the private key to Signature, and through http header X-signaturetransmission.
SignatureData itemDescriptionExample
App idSource in the request headers X-app-id-
Request IdSource in the request headers X-request-id-
Path with Query ParamsSource in the requestURL, containing only path and request parameters/api/v1/ex/onboarding/merchant/100/kyc/query-status?a=1
Request payloadcomplete requestBody jsonstring-

1.2. Partner verify the response signature#

EurewaX Platform synchronous response request when will for response parameters perform Signature, Partner Required Use EurewaX of public key verify the response signature, response Signature through response header X-signature transmission.
Signature Data itemDescriptionExample
App idSource in the request headers X-app-id-
Path with Query ParamsSource in the request URL, containing only path and request parameters/api/v1/ex/onboarding/merchant/100/kyc/query-status?a=1
Request payloadcomplete responseBody jsonstring-

2. [File Upload ]API#

2.1. Partner process the requestSignature#

due to File Upload of special characteristics, rulesthen and standard through APIs lightly not same :
Partner call [Upload File ]APIbefore , Required uses SHA512for File generate checksum
will checksumas Queryparameterpass pass
Signature Data itemDescriptionExample
App idSource in the request headers X-app-id-
Request IdSource in the request headers X-request-id-
Path with Query ParamsSource in the request URL, containing only pathand request parameters/api/v1/ex/common/file/upload?checksum=xxxxxxxxxxxx

2.2. Partner verify the response signature#

same standard through API of responsesignature verification.

3. EurewaX Notification#

when EurewaX Platform proactively to Partner Platform send Notification when , EurewaX will Use EurewaX private key for Notification request perform Signature, and through http header X-signature transmission.
Partner Platform Required Use EurewaX verify with the public key.
Signature Data itemDescriptionExample
Request payloadcomplete request Body json string-
Modified at 2026-08-08 08:23:50
Previous
Message Structure
Next
Encryption
Built with