Retrieve pending card authorizations

curl --request GET \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/authorizations \
  --header 'Api-Key: <api-key>'

{
  "count": 123,
  "data": [
    {
      "id": "<string>",
      "amount": "<string>",
      "currency": "usd",
      "merchant_category_code": "<string>",
      "description": "<string>",
      "authorized_at": "<string>",
      "details": {
        "vendor_auth_id": "<string>"
      },
      "billing_amount": "<string>",
      "local_transaction_details": {
        "amount": "<string>",
        "currency": "<string>",
        "exchange_rate": "<string>"
      },
      "verification_data": {
        "address_check": "match",
        "address_postal_code_check": "match",
        "cvv_check": "match",
        "pin_check": "verified",
        "three_d_secure_check": "attempt_acknowledged"
      }
    }
  ]
}

GET

customers

{customerID}

card_accounts

{cardAccountID}

authorizations

Retrieve pending card authorizations

curl --request GET \
  --url https://api.bridge.xyz/v0/customers/{customerID}/card_accounts/{cardAccountID}/authorizations \
  --header 'Api-Key: <api-key>'

{
  "count": 123,
  "data": [
    {
      "id": "<string>",
      "amount": "<string>",
      "currency": "usd",
      "merchant_category_code": "<string>",
      "description": "<string>",
      "authorized_at": "<string>",
      "details": {
        "vendor_auth_id": "<string>"
      },
      "billing_amount": "<string>",
      "local_transaction_details": {
        "amount": "<string>",
        "currency": "<string>",
        "exchange_rate": "<string>"
      },
      "verification_data": {
        "address_check": "match",
        "address_postal_code_check": "match",
        "cvv_check": "match",
        "pin_check": "verified",
        "three_d_secure_check": "attempt_acknowledged"
      }
    }
  ]
}

Authorizations

Api-Key

string

header

required

Path Parameters

customerID

string

required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

cardAccountID

string

required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Query Parameters

limit

integer

The number of pending card authorizations to return, with a max of 200. The default is 100

starting_time

string

The starting time in ISO8601 format. Default is 50 days ago.

ending_time

string

The exclusive ending time in ISO8601 format. Default is now.

status

enum<string>

A status to filter the authorizations by. If not provided, will default to approved.

Available options:

approved,

denied

Response

Pending card authorizations

count

integer

required

The number of card authorizations returned

data

object[]

required

Show child attributes

data.id

string

required

ID of the pending authorization

Required string length: 1 - 42

data.amount

string

required

The amount represented as a decimal string

data.currency

enum<string>

required

The currency of the transaction

Available options:

usd

data.merchant_category_code

string

required

A merchant category code for card transactions (e.g., '5712')

data.description

string

required

A description of the card transaction, including the merchant's name and location information

data.authorized_at

string

required

Timestamp when the card transaction was authorized, in ISO8601 format

data.details

object

required

Show child attributes

data.details.vendor_auth_id

string

ID in the vendor system used to identify this authorized card transaction

data.billing_amount

string

The billing amount, represented as a decimal string. The billing amount is the amount of the transaction excluding any additional hold. This amount should be present on all purchases, but will only differ from the amount field for some merchant categories in which an upcharge is involved (e.g. gas stations, hotels).

data.local_transaction_details

object

Details of a transaction processed in a local currency other than USD, with currency conversion applied

Show child attributes

data.local_transaction_details.amount

string

required

The amount in local currency, represented as a decimal string

data.local_transaction_details.currency

string

required

The transaction's local currency

data.local_transaction_details.exchange_rate

string

required

The exchange rate applied to convert the local currency amount into USD for the transaction

data.verification_data

object

Information on verifications that were performed on information that the cardholder provided to the merchant.

Show child attributes

data.verification_data.address_check

enum<string>

Whether the cardholder provided an address and if it matched the cardholder’s address on file.

Available options:

match,

not_provided,

mismatch

data.verification_data.address_postal_code_check

enum<string>

Whether the cardholder provided a postal code and if it matched the cardholder’s postal code on file.

Available options:

match,

not_provided,

mismatch

data.verification_data.cvv_check

enum<string>

Whether the cardholder provided a CVV and if it matched the CVV on record.

Available options:

match,

not_provided,

mismatch

data.verification_data.pin_check

enum<string>

Whether the cardholder provided a PIN and if it matched the PIN on record.

Available options:

verified,

failed,

locked,

not_set,

blocked,

no_pin_passed,

unknown

data.verification_data.three_d_secure_check

enum<string>

The results of the 3DS authentication attempt for this authorization, if applicable.

Available options:

attempt_acknowledged,

authenticated,

failed,

required

Create a mobile wallet push provisioning request Retrieve card transactions

⌘I

Endpoints

Authorizations

Path Parameters

Query Parameters

Response