ACacquired
Transactions

Retrieve a transaction

Changed on

Every time you submit a payment request, including, card, recurring payments, Google Pay, Apple Pay, you are returned a transaction_id. Append the transaction_id to the URL to retrieve the transaction details.

get/transactions/{transaction_id}

Request

Path parameters

transaction_idstring uuid required

Unique ID assigned by Acquired.com for the transaction.

Query parameters

filterstring

Filter the parameters that you want to return within the response.

Response

OK

transaction_idstring uuid

Unique identifier assigned by Acquired.com for the transaction.

status'blocked' | 'declined' | 'success' | 'tds_error' | 'tds_expired' | 'tds_failed' | 'settled' | 'executed' | 'cancelled' | 'expired'

The current status of the transaction.

reason'6012_data' | 'above_max_amount' | 'above_max_refund_amount' | 'above_max_transactions' | 'acs_technical_issue' | 'bad_gateway' | 'below_min_amount' | 'below_min_refund_amount' | 'bin_bank' | 'bin_country' | 'bin_level' | 'bin_product' | 'bin_scheme' | 'blocklist_bin' | 'blocklist_card' | 'blocklist_email' | 'blocklist_ip' | 'blocklist_phone' | 'card_authentication_failed' | 'card_not_active' | 'cardholder_cancellation' | 'cardholder_cancelled' | 'challenge_failed' | 'challenge_limit_exceeded' | 'challenge_not_completed' | 'challenge_time_out' | 'closed_account' | 'exceeds_authentication_frequency_limit' | 'exceeds_max_amount' | 'exceeds_max_refund_amount' | 'exceeds_max_transactions' | 'expired_card' | 'fraud_scoring' | 'fraud_scoring_error' | 'generic_decline' | 'insufficient_funds' | 'invalid_avs' | 'invalid_card_number' | 'invalid_cvv' | 'invalid_pin' | 'invalid_transaction' | 'low_confidence' | 'lost_or_stolen' | 'max_amount_day' | 'max_amount_month' | 'max_card_attempts' | 'max_card_success' | 'max_daily_refunds_amount' | 'max_daily_refunds_count' | 'max_email_day' | 'max_email_month' | 'max_ip_day' | 'max_ip_month' | 'max_monthly_refunds_amount' | 'max_monthly_refunds_count' | 'max_phone_day' | 'max_phone_month' | 'max_post_day' | 'max_post_month' | 'max_refunds_count' | 'medium_confidence' | 'no_card_record' | 'restricted_card' | 'scheme_status_reason' | 'security_failure' | 'suspected_fraud' | 'transaction_disputed' | 'transaction_fraud' | 'transaction_not_permitted_to_cardholder'
mid'card' uuid

Unique ID assigned by Acquired.com for the associated MID.

payment_method'card' | 'apple_pay' | 'google_pay' | 'mastercard_send' | 'visa_direct' | 'faster_payment_send' | 'pay_by_bank' | 'direct_debit'

Detail of how the transaction has been executed.

transaction_type'sale' | 'authorisation' | 'capture' | 'refund' | 'void' | 'credit' | 'account_to_account' | 'reversal'

The detail of what type of transaction was performed (such as receiving or sending funds).

issuer_response_code'00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '1A' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '43' | '44' | '45' | '46' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59' | '5C' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '69' | '6P' | '70' | '71' | '72' | '73' | '74' | '75' | '76' | '77' | '78' | '79' | '80' | '81' | '82' | '83' | '84' | '85' | '86' | '87' | '88' | '89' | '90' | '91' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '99' | '9G' | 'B1' | 'N0' | 'N3' | 'N4' | 'N7' | 'P5' | 'P6' | 'R0' | 'R1' | 'R3' | 'XA' | 'XD'
authorization_codestring

Credit card code to indicate whether the transaction has been approved or declined.

acquirer_reference_numberstring

Unique reference number assigned to the transaction as it moves through the payment flow.

scheme_reference_datastring

Unique reference generated by the card scheme.

transaction_link_idstring nullable

Mastercard Transaction Link Identifier (TLID). Generated by Mastercard on the cardholder-initiated transaction that sets up a stored credential agreement, and used to link every later merchant-initiated transaction to it. Returned for Mastercard payments only; null when no TLID is available.

card_idstring uuid

Unique ID assigned by Acquired.com for the card.

createdstring date-time

The date and time at which the customer was created.

last_updatedstring date-time

The date and time the customer record was last updated.

credential_on_file'first' | 'recurring'

Used to identify whether the transaction is the first or a subsequent transaction.

custom_datastring

Base64 encoded string detailing custom data passed in the request.

custom1string

Send additional data relating to the customer or another internal reference. Do not include PII (names, emails, phone numbers, or other sensitive data).

custom2string

Send additional data relating to the customer or another internal reference. Do not include PII (names, emails, phone numbers, or other sensitive data).

charge_datestring date

Populate this parameter if you want to set the initial Direct Debit collection for a date in the future, rather than the collection being processed on the next working day.

is_retryableboolean

Confirms whether the Direct Debit can be retried or not.

Example response

{
  "transaction_id": "a7e3fde5-5b83-44f4-9915-782bc7121717",
  "status": "success",
  "transaction": {
    "order_id": "1f1f2a61-5b68-4725-a0ce-9560514ec00b",
    "amount": 15.02,
    "currency": "GBP",
    "billing": {
      "subscription_id": "01JC4Z1YR25RSAFVHYY7GA1BRQ",
      "bill_id": "01JC4Z2BC9J1V1B8YHR4E0X4T5",
      "recovery_id": "01JC4Z2Y0Q4E7Q0YV5D3M6W9KA"
    }
  },
  "retry_advice": {
    "category": "retry_later",
    "detail": null,
    "retry_after": "2026-03-04T00:00:00Z",
    "acquirer_code": "25"
  },
  "issuer_response_code": "00",
  "authorization_code": "123456",
  "acquirer_reference_number": "AA07071660000001",
  "scheme_reference_data": "987654321234567",
  "transaction_link_id": "ex9D-Gm0NN9Gaih0zZ0s99",
  "payment": {
    "reference": "Custom Ref 001",
    "payee_id": "4ebc5489-7b9f-4324-983e-07d4b2b00035"
  },
  "payer": {
    "account_name": "MR E JOHNSON",
    "account_number": "12345678",
    "sort_code": "010203"
  },
  "card": {
    "holder_name": "E Johnson",
    "scheme": "visa",
    "number": "8710",
    "expiry_month": 10,
    "expiry_year": 30
  },
  "bin": {
    "number": "424242",
    "type": "debit",
    "product": "consumer",
    "card_level": "standard",
    "issuer": "acquired.com",
    "issuer_country": "united kingdom",
    "issuer_country_code": "gb"
  },
  "customer": {
    "reference": "customer_number_00001",
    "first_name": "Edward",
    "last_name": "Johnson",
    "dob": "1988-10-03",
    "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh",
    "billing": {
      "address": {
        "line_1": "152 Aldgate Drive",
        "city": "London",
        "postcode": "E1 7RT",
        "country_code": "GB"
      },
      "email": "ejohnson@acquired.com",
      "phone": {
        "country_code": "44",
        "number": "2039826580"
      }
    },
    "shipping": {
      "first_name": "Edward",
      "last_name": "Johnson",
      "address": {
        "line_1": "152 Aldgate Drive",
        "city": "London",
        "postcode": "E1 7RT",
        "country_code": "GB"
      },
      "email": "ejohnson@acquired.com",
      "phone": {
        "country_code": "44",
        "number": "2039826580"
      }
    }
  },
  "credential_on_file": "first",
  "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh",
  "custom1": "12345",
  "custom2": "123456",
  "charge_date": "2024-08-05",
  "detail": {
    "scheme": "bacs",
    "report": "ARUDD",
    "reason_code": "1"
  }
}

Changes

  • 9c9e8ec96e98Revision changes
    • breaking

      the / response's property type changed from string to integer for status

    • warning

      removed the optional property from the response with the status

    • warning

      added the new 1.00 enum value to the / response property for the response status

    • warning

      added the new 10.00 enum value to the / response property for the response status

    • warning

      added the new 11.00 enum value to the / response property for the response status

    • warning

      added the new 12.00 enum value to the / response property for the response status

    • warning

      added the new 13.00 enum value to the / response property for the response status

    • warning

      added the new 14.00 enum value to the / response property for the response status

    • warning

      added the new 15.00 enum value to the / response property for the response status

    • warning

      added the new 16.00 enum value to the / response property for the response status

    • warning

      added the new 17.00 enum value to the / response property for the response status

    • warning

      added the new 18.00 enum value to the / response property for the response status

    • warning

      added the new 19.00 enum value to the / response property for the response status

    • warning

      added the new 1A enum value to the response property for the response status

    • warning

      added the new 2.00 enum value to the / response property for the response status

    • warning

      added the new 20.00 enum value to the / response property for the response status

    • warning

      added the new 21.00 enum value to the / response property for the response status

    • warning

      added the new 22.00 enum value to the / response property for the response status

    • warning

      added the new 23.00 enum value to the / response property for the response status

    • warning

      added the new 24.00 enum value to the / response property for the response status

    • warning

      added the new 25.00 enum value to the / response property for the response status

    • warning

      added the new 26.00 enum value to the / response property for the response status

    • warning

      added the new 27.00 enum value to the / response property for the response status

    • warning

      added the new 28.00 enum value to the / response property for the response status

    • warning

      added the new 3.00 enum value to the / response property for the response status

    • warning

      added the new 4.00 enum value to the / response property for the response status

    • warning

      added the new 45 enum value to the response property for the response status

    • warning

      added the new 46 enum value to the response property for the response status

    • warning

      added the new 49 enum value to the response property for the response status

    • warning

      added the new 5.00 enum value to the / response property for the response status

    • warning

      added the new 50 enum value to the response property for the response status

    • warning

      added the new 58 enum value to the response property for the response status

    • warning

      added the new 5C enum value to the response property for the response status

    • warning

      added the new 6.00 enum value to the / response property for the response status

    • warning

      added the new 69 enum value to the response property for the response status

    • warning

      added the new 6P enum value to the response property for the response status

    • warning

      added the new 7.00 enum value to the / response property for the response status

    • warning

      added the new 70 enum value to the response property for the response status

    • warning

      added the new 71 enum value to the response property for the response status

    • warning

      added the new 72 enum value to the response property for the response status

    • warning

      added the new 73 enum value to the response property for the response status

    • warning

      added the new 74 enum value to the response property for the response status

    • warning

      added the new 78 enum value to the response property for the response status

    • warning

      added the new 79 enum value to the response property for the response status

    • warning

      added the new 8.00 enum value to the / response property for the response status

    • warning

      added the new 9.00 enum value to the / response property for the response status

    • warning

      added the new 9G enum value to the response property for the response status

    • warning

      added the new AED enum value to the / response property for the response status

    • warning

      added the new AUD enum value to the / response property for the response status

    • warning

      added the new B1 enum value to the response property for the response status

    • warning

      added the new CAD enum value to the / response property for the response status

    • warning

      added the new CHF enum value to the / response property for the response status

    • warning

      added the new CNY enum value to the / response property for the response status

    • warning

      added the new DKK enum value to the / response property for the response status

    • warning

      added the new EUR enum value to the / response property for the response status

    • warning

      added the new GBP enum value to the / response property for the response status

    • warning

      added the new HKD enum value to the / response property for the response status

    • warning

      added the new JPY enum value to the / response property for the response status

    • warning

      added the new MXN enum value to the / response property for the response status

    • warning

      added the new R0 enum value to the response property for the response status

    • warning

      added the new R1 enum value to the response property for the response status

    • warning

      added the new R3 enum value to the response property for the response status

    • warning

      added the new SEK enum value to the / response property for the response status

    • warning

      added the new USD enum value to the / response property for the response status

    • warning

      added the new ZAR enum value to the / response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the acs_technical_issue enum value from the / response property for the response status

    • info

      removed the aed enum value from the / response property for the response status

    • info

      removed the aud enum value from the / response property for the response status

    • info

      removed the bad_gateway enum value from the / response property for the response status

    • info

      removed the cad enum value from the / response property for the response status

    • info

      removed the challenge_failed enum value from the / response property for the response status

    • info

      removed the challenge_limit_exceeded enum value from the / response property for the response status

    • info

      removed the challenge_not_completed enum value from the / response property for the response status

    • info

      removed the chf enum value from the / response property for the response status

    • info

      removed the cny enum value from the / response property for the response status

    • info

      removed the dkk enum value from the / response property for the response status

    • info

      removed the eur enum value from the / response property for the response status

    • info

      removed the gbp enum value from the / response property for the response status

    • info

      removed the hkd enum value from the / response property for the response status

    • info

      removed the invalid_transaction enum value from the / response property for the response status

    • info

      removed the jpy enum value from the / response property for the response status

    • info

      removed the low_confidence enum value from the / response property for the response status

    • info

      removed the mxn enum value from the / response property for the response status

    • info

      removed the no_card_record enum value from the / response property for the response status

    • info

      removed the security_failure enum value from the / response property for the response status

    • info

      removed the sek enum value from the / response property for the response status

    • info

      removed the soft_decline enum value from the / response property for the response status

    • info

      removed the soft_decline enum value from the / response property for the response status

    • info

      removed the suspected_fraud enum value from the / response property for the response status

    • info

      removed the usd enum value from the / response property for the response status

    • info

      removed the zar enum value from the / response property for the response status

    • info

      the // response's property pattern was changed from \w+([-+.]\w*)*@ to ^\w+([-+.]\w*)*@\w+([-+.]\w+)*\.\w+([-+.]\w+)*$ for the status

    • info

      the // response's property pattern was changed from \w+([-+.]\w*)*@ to ^\w+([-+.]\w*)*@\w+([-+.]\w+)*\.\w+([-+.]\w+)*$ for the status