Update an order

POST

https://test-api.star-saas.com/v1/updateOrders

This endpoint is only for transactions that only use risk product Pulse .
It allows you to update the transaction information (include status, 3DS verification, etc) of no more than 50 orders at one time, this information is very helpful to optimize risk.

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

Example:

15670

account_id

string

required

Subaccount ID or Gateway Number

<= 10 characters

Example:

15670001

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.

update_orders

array [object {3}]

required

List of trade 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

<= 64 characters

Example:

1667308950627942400

status

string

required

Status to be updated
0: Fail
1: Success

<= 1 characters

Example:

ispass3d

string

required

3DS Status to be updated
0: no 3D
1: yes 3D

<= 1 characters

Example:

Example

{
  "merchant_id": "15670",
  "account_id": "15670001",
  "encryption_data": "7ECECE4B1687DC8E4A6B5B8086AE68CBC567E33D8B5DFDC810DBDE077CB377E4",
  "update_orders": [
    {
      "transaction_id": "1667308950627942400",
      "status": "1",
      "ispass3d": "1"
    },
    {
      "transaction_id": "1667309703538147328",
      "status": "0",
      "ispass3d": "1"
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-api.star-saas.com/v1/updateOrders' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-raw '{
    "merchant_id": "15670",
    "account_id": "15670001",
    "encryption_data": "7ECECE4B1687DC8E4A6B5B8086AE68CBC567E33D8B5DFDC810DBDE077CB377E4",
    "update_orders": [
        {
            "transaction_id": "1667308950627942400",
            "status": "1",
            "ispass3d": "1"
        },
        {
            "transaction_id": "1667309703538147328",
            "status": "0",
            "ispass3d": "1"
        }
    ]
}'

Responses

🟢200Success

application/json

Body

merchant_id

string

required

account_id

string

required

return_message

string

required

return_status

string

required

encryption_data

string

required

Example

{
  "merchant_id": "15670",
  "account_id": "15670001",
  "return_message": "OK",
  "return_status": "1",
  "encryption_data": "7ECECE4B1687DC8E4A6B5B8086AE68CBC567E33D8B5DFDC810DBDE077CB377E4"
}

Optimise payment methods

Create cardholder