Update Decision

Updates an existing decision that is in manual review status.

Endpoint: PUT /v1/risk/{transaction_id}

Headers

Content-Type: application/json
x-api-key: <YOUR_API_KEY>

Attributes of the request

This request is used when a transaction is pending for a review, and the customer need to update the information to approve the transaction, it has the following attributes

transaction_info {object}

Required: true

Represents the information details of the request in a JSON object. The object has the following attributes:

• type: string Type value represent the type of request that is sent.

  Example: “authorization”

  Required: true

action_info {object}

Required: true Represents the action information object, that has the attributes:

• decision_id: string

  Example: “8475986574758978745”

  Required: true

  The unique identifier of the decision.

• decision: string

  Example: “Accept”

  Required: true

  The decision value that will be updated.

• comments: string

  Example: 01/27

  Required: false

  An additional comment if need it.number: int Represents a Luhm compliant credit card value. Example: "4242424242424242" Required: true

Attributes of the response

• status: string The status is a string result that only has three possible values. "Success", "Fail" or “error”.

• message: string The message value represents a short description about the status received.

• data: {object} The data variable represents the information expected from the request made. This contains the payment information and the decision of the transaction

Request

Path Parameters

Parameter	Type	Required	Description
transaction_id	string	Yes	Transaction ID obtained from the create_decision endpoint

Request Body

{
    "transaction_info": {
        "type": "update_decision",
        "reference_code": "123456789"
    },
    "action_info": {
        "decision_id": "0001751371880962364299",
        "decision": "ACCEPT",
        "comments": "This is a test comment"
    }
}

Parameters

Field	Type	Required	Description
transaction_info.type	string	Yes	Must be "update_decision"
transaction_info.reference_code	string	Yes	Original transaction reference code
action_info.decision_id	string	Yes	Decision ID to update
action_info.decision	string	Yes	New decision: "ACCEPT" or "REJECT"
action_info.comments	string	Optional	Comments about the decision

Response

{
    "status": "success",
    "message": "Action requested successfully",
    "data": {
        "transaction_info": {
            "type": "update_decision_response",
            "reference_code": "123456789",
            "transaction_id": "0001751371985314254833",
            "request_id": "7513718812276466904806",
            "status": "Accepted",
            "created_at": "2025-07-01T12:13:06.104277455Z"
        }
    }
}

Usage Examples

cURL - Update Decision

curl --location --request PUT 'https://api.firstoken.co/v1/risk/0001751371880962364299' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <YOUR_API_KEY>' \
--data '{
    "transaction_info": {
        "type": "update_decision",
        "reference_code": "123456789"
    },
    "action_info": {
        "decision_id": "0001751371880962364299",
        "decision": "ACCEPT",
        "comments": "Transaction approved after manual review"
    }
}'