2025-03-25
  • 2025-03-25
  • 2025-01-20
  • 2022-03-14
Help Center
VCCHUB How-to
2025-03-25
  • 2025-03-25
  • 2025-01-20
  • 2022-03-14
  1. Acquiring
  • 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
    • Issuing
      • Cardholder
        • Create 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
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Acquiring

Query a transaction

POST
https://test-api.star-saas.com/v1/retrievalTrans
Query up to 100 orders in a single request.
Merchant may use this interface to synchronise order status on merchant’s internal systems to our gateway system.
Please note, due to security concern, merchant needs to provide the IP addresses to our gateway system for registration before using this interface.

Request

Header Params

Body Params application/x-www-form-urlencoded

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test-api.star-saas.com/v1/retrievalTrans' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'merchant_id=701001' \
--data-urlencode 'account_id=701001010' \
--data-urlencode 'encryption_data='

Responses

🟢200Success
application/json
Body

Example
"merchant_id": "1018801",
"account_id": "1018801057",
"return_status": "1",
"return_message": "OK",
"orders_list": [{
	"amount": "261.41",
	"currency": "USD",
	"delivery_information": {
		"delivery_address": "test",
		"delivery_city": "test",
		"delivery_country": "US",
		"delivery_firstname": "test",
		"delivery_lastname": "test",
		"delivery_postal_code": "100000",
		"delivery_state": "fj"
	},
    "antifraud_provider": "Forter",
    "fraud_check_result": [
        {
            "check_items": "Approved By Forter",
            "status": "ACCEPT"
        },
        {
            "check_items": "PaymentToken is incorreet".
            "status": "REJECT"
        }
    ],
	"is3ds": "0",
	"order_no": "1751877054655",
	"payment_status": "3000",
	"query_result": "1",
	"reference_no": "369376110235",
	"shopper_email": "approve@forter.com",
	"shopper_phone": "13552535506",
	"subscription_result": {
		"contract_name": "17518770546253",
		"recurring_deduction_period": "1",
		"recurring_deduction_time": "2025-07-07",
		"recurring_id": "c6f91e55-a85d-4283-ab32-c90cb48132d4",
		"recurring_status": "1"
	},
	"transaction_date": "20250707172349",
	"transaction_id": "369376110235",
	"website": "website.com"
}]
Previous
Create a redirect (iFrame) payment
Next
Capture a transaction