Deprecated API Reference

This API Reference is being deprecated. Please use the New API Reference.

Fetch an Authorization

Fetch a previously created authorization resource.

Copy
Copied
curl https://finix.sandbox-payments-api.com/authorizations/AUvAZfiEH7irXZf49P7o8P1r \
    -H "Content-Type: application/vnd.json+api" \
    -H 'Finix-Version:2022-02-01' \
    -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e

Example Response:

Copy
Copied
{
  "id" : "AUvAZfiEH7irXZf49P7o8P1r",
  "application" : "APgPDQrLD52TYvqazjHJJchM",
  "amount" : 100,
  "tags" : {
    "order_number" : "21DFASJSAKAS"
  },
  "state" : "SUCCEEDED",
  "currency" : "USD",
  "transfer" : "TRsBcF8LjV1UaK5vXY6pFHmG",
  "messages" : [ ],
  "raw" : null,
  "created_at" : "2022-01-27T07:37:19.16Z",
  "updated_at" : "2022-01-27T07:37:25.50Z",
  "trace_id" : "b9e38593-da27-49e7-b948-f6c1d59d5e7e",
  "source" : "PIe2YvpcjvoVJ6PzoRPBK137",
  "merchant_identity" : "IDpYDM7J9n57q849o9E9yNrG",
  "3ds_redirect_url" : null,
  "is_void" : false,
  "void_state" : "UNATTEMPTED",
  "expires_at" : "2022-02-03T07:37:19.16Z",
  "idempotency_id" : null,
  "failure_code": null,
  "failure_message": null,
  "_links" : {
    "self" : {
      "href" : "https://finix.sandbox-payments-api.com/authorizations/AUvAZfiEH7irXZf49P7o8P1r"
    },
    "application" : {
      "href" : "https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM"
    },
    "transfer" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRsBcF8LjV1UaK5vXY6pFHmG"
    },
    "merchant_identity" : {
      "href" : "https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG"
    }
  }
}

HTTP Request

GET https://finix.sandbox-payments-api.com/authorizations/:AUTHORIZATION_ID

URL Parameters

Parameter Description
:AUTHORIZATION_ID ID of the Authorization

Response

Field Type Description
id string The ID of the authorization resource
application object The ID of the Application resource the authorization was created under
amount string The total amount that will be debited in cents (e.g. 100 cents to debit $1.00)
tags string Key value pair for annotating custom meta data (e.g. order numbers)
state string The state of the authorization. Available values include:
  • CANCELED
  • PENDING
  • FAILED
  • SUCCEEDED
  • UNKNOWN
currency string ISO 4217 3 letter currency code
transfer string The ID of the transfer resource that gets created when the authorization moves to SUCCEEDED
messages string Message field that provides additional details. This field is typically null
raw string Raw response from the processor
created_at string Timestamp of when the object was created
updated_at string Timestamp of when the object was last updated
trace_id string Trace ID of the authorization. The processor sends back the trace_id so you can track the authorization end-to-end
source string ID of the Payment Instrument where funds get debited
merchant_identity string The ID of the Identity resource associated with the merchant
3ds_redirect_url string The redirect URL used for 3DS transactions (if supported by the processor)
is_void string Details if the authorization is void
void_state string Details if the authorization has been voided
expires_at string Authorization expiration time
idempotency_id string A randomly generated value that'll be associated with the request
failure_code string A failure_code is provided when a transaction is declined. For more information on how to handle failure_codes see Failure Codes
failure_message string Additional information about the failure_code and why the transaction was declined. For more information on how to handle failure_codes see Failure Codes