Skip to main content
POST
/
preauth
/
update
curl --request POST \
  --url https://testapi.fractalpay.com/api/v1/preauth/update \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "merchant_key": "{{merchant_key}}",
  "transaction_id": "txn_77c9a625a3",
  "last_authorized_amount": "10.00",
  "new_authorized_amount": "11.00",
  "order_id": "5467"
}
'
{
  "result": true,
  "message": "Amount Updated Successfully",
  "data": {
    "Status": "Approved",
    "Account": "0043",
    "Brand": "Visa",
    "AuthCode": "",
    "Authorized": "11.00",
    "transaction_id": "txn_77c9a625a3",
    "orderid": "5467"
  }
}

Authorizations

​
Authorization
string
header
required

Use your Fractal API credentials.

Username = Client ID Password = Secret Key

Sandbox credentials can be generated from the Test Portal.

Body

application/json
​
merchant_key
string
required

The merchant's unique API key.

Example:

"{{merchant_key}}"

​
transaction_id
string
required

The guid of the existing preauthorization to update. Always use the original preauthorization transaction ID — not the ID returned by a previous update.

Example:

"txn_77c9a625a3"

​
last_authorized_amount
string
required

The current authorized amount. Must match the amount on record or the request returns an Amount mismatch error.

Example:

"10.00"

​
new_authorized_amount
string
required

The target authorized amount. Greater than last_authorized_amount triggers an increment; less triggers a decrement.

Example:

"11.00"

​
order_id
string

Your order reference.

Example:

"5467"

Response

Authorization updated successfully

​
result
boolean
Example:

true

​
message
string
Example:

"Amount Updated Successfully"

​
data
object