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",
  "created_at" : "2022-01-27T07:37:19.16Z",
  "updated_at" : "2022-01-27T07:37:25.50Z",
  "3ds_redirect_url" : null,
  "additional_buyer_charges" : null,
  "additional_healthcare_data" : null,
  "address_verification" : "POSTAL_CODE_AND_STREET_MATCH",
  "amount" : 100,
  "amount_requested" : 100,
  "application" : "APgPDQrLD52TYvqazjHJJchM",
  "currency" : "USD",
  "expires_at" : "2022-02-03T07:37:19.16Z",
  "failure_code" : null,
  "failure_message" : null,
  "idempotency_id" : null,
  "is_void" : false,
  "merchant_identity" : "IDpYDM7J9n57q849o9E9yNrG",
  "messages" : [ ],
  "raw" : null,
  "security_code_verification" : "MATCHED",
  "source" : "PIe2YvpcjvoVJ6PzoRPBK137",
  "state" : "SUCCEEDED",
  "tags" : {
    "order_number" : "21DFASJSAKAS"
  },
  "trace_id" : "b9e38593-da27-49e7-b948-f6c1d59d5e7e",
  "transfer" : "TRsBcF8LjV1UaK5vXY6pFHmG",
  "void_state" : "UNATTEMPTED",
  "_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
`created_at`	string	Timestamp of when the object was created
`updated_at`	string	Timestamp of when the object was last updated
`3ds_redirect_url`	string	The redirect URL used for 3DS transactions (if supported by the processor)
`amount`	string	The total amount that will be debited in cents (e.g. 100 cents to debit $1.00)
`application`	object	The ID of the `Application` resource the `Authorization` was created under
`currency`	string	ISO 4217 3 letter currency code
`expires_at`	string	Authorization expiration time
`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
`idempotency_id`	string	A randomly generated value that'll be associated with the request
`is_void`	string	Details if the `Authorization` is void
`merchant_identity`	string	The ID of the `Identity` resource associated with the `Merchant`
`messages`	string	Message field that provides additional details. This field is typically null
`raw`	string	Raw response from the processor
`source`	string	ID of the `Payment Instrument` where funds get debited
`state`	string	The state of the `Authorization`. Available values include: CANCELED PENDING FAILED SUCCEEDED UNKNOWN
`tags`	string	Key value pair for annotating custom meta data (e.g. order numbers)
`trace_id`	string	Trace ID of the `Authorization`. The processor sends back the `trace_id` so you can track the authorization end-to-end
`transfer`	string	The ID of the `Transfer` resource that gets created when the `Authorization` moves to SUCCEEDED
`void_state`	string	Details if the `Authorization` has been voided