Review a transaction

Request

Header Params

Content-Type

string

required

Example:

application/x-www-form-urlencoded

Body Params application/json

merchant_id

string

required

Merchant Code or Merchant ID or Merchant Number

<= 7 characters

account_id

string

required

Account ID or Gateway Number

<= 10 characters

encryption_data

string

required

Digital signatures information
encryption_data=sha256(merchant_id + account_id + transaction_id1 + transaction_id2 ...+ sign_key);
All encryption parameters need to remove spaces before encryption.

<= 64 characters

Example:

21594215940011524288089406BRL28

review_orders

array [object {5}]

required

List of reviewed orders Up to 50 orders in a single request

transaction_id

string

required

Transaction ID generated by gateway system, the Transaction ID = Order No + '-' + 5 digits random number

<= 50 characters

Example:

1941996290307513125

order_no

string

required

Merchant Order Number

<= 50 characters

Example:

1462430729923

currency

string

required

Transaction currency

<= 3 characters

Example:

USD

amount

string

required

Full order amount

<= 15 characters

Example:

188.00

review_flag

string

1

required

Review Result
1: Accept
0: Reject

<= 1 characters

Example

{
  "merchant_id": "1018001",
  "account_id": "1018001014",
  "encryption_data": "4a051ef2f31c0244a2516325b035cdd0e49e53533414cc7b2f5fe07496d6d0ac",
  "review_orders": [
    {
      "transaction_id": "1379870771222937600",
      "order_no": "1731485354355",
      "currency": "USD",
      "amount": "11.55",
      "review_flag": "1"
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://test-api.star-saas.com/v1/review' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-raw '{
    "merchant_id": "1018001",
	"account_id": "1018001014",
	"encryption_data": "4a051ef2f31c0244a2516325b035cdd0e49e53533414cc7b2f5fe07496d6d0ac",
    "review_orders":[
        {
            "transaction_id": "1379870771222937600",
		    "order_no": "1731485354355",
            "currency": "USD",
            "amount": "11.55",
            "review_flag":"1"
        }
    ]
}'

Responses

🟢200Success

application/json

Body

account_id

string

required

return_message

string

required

return_status

string

required

encryption_data

string

required

merchant_id

string

required

review_orders

array [object {7}]

required

amount

string

required

currency

string

required

error_message

string

required

order_no

string

required

review_flag

string

required

review_status

string

required

transaction_id

string

required

Example

{
  "account_id": "1018001014",
  "return_message": "OK",
  "return_status": "1",
  "encryption_data": "4a051ef2f31c0244a2516325b035cdd0e49e53533414cc7b2f5fe07496d6d0ac",
  "merchant_id": "1018001",
  "review_orders": [
    {
      "amount": "11.55",
      "currency": "USD",
      "error_message": "",
      "order_no": "1731485354355",
      "review_flag": "1",
      "review_status": "1",
      "transaction_id": "1379870771222937600"
    }
  ]
}