Query a transaction

POST

/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 samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-api.sufupayment.com/v1/retrievalTrans' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'merchant_id=701001' \
--data-urlencode 'account_id=701001010' \
--data-urlencode 'orders=1726890189565' \
--data-urlencode 'trades=' \
--data-urlencode 'platform_source=Shopify' \
--data-urlencode 'order_status=' \
--data-urlencode 'query_start=2025-07-06 00:23:49' \
--data-urlencode 'query_end=2025-07-07 00:23:49' \
--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"
}]

Modified at 2025-08-05 01:20:36

Create a redirect (iFrame) payment

Refund a transaction