ACacquired
Payments

Apple Pay

Changed on

When the user selects the Apple Pay button a payment request will be created and an encrypted payload will be returned to us.

post/payments/apple-pay

Request

Headers

Company-Idstring uuid

Unique ID assigned by Acquired.com for your company.

Midstring uuid

Unique ID assigned by Acquired.com connecting to a specific acquiring bank.

Request body

Example request

{
  "transaction": {
    "order_id": "1f1f2a61-5b68-4725-a0ce-9560514ec00b",
    "amount": 15.02,
    "currency": "GBP",
    "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh"
  },
  "payment": {
    "scheme": "visa",
    "type": "debit",
    "display_name": "**** 8710",
    "reference": "Custom Ref 001",
    "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh"
  },
  "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"
      }
    }
  }
}

Response

Created

transaction_idstring uuid

Unique identifier assigned by Acquired.com for the transaction.

status'success' | 'declined' | 'blocked'
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'
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'
card_idstring uuid

Unique identifier assigned by us for the card.

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.

Example response

{
  "transaction_id": "a7e3fde5-5b83-44f4-9915-782bc7121717",
  "status": "success",
  "issuer_response_code": "00",
  "retry_advice": {
    "category": "retry_later",
    "detail": null,
    "retry_after": "2026-03-04T00:00:00Z",
    "acquirer_code": "25"
  },
  "card_id": "a84fb738-0886-42ca-8711-3d6c0f586b08",
  "transaction_link_id": "ex9D-Gm0NN9Gaih0zZ0s99",
  "links": [
    {
      "rel": "self",
      "href": "/v1/transactions/a7e3fde5-5b83-44f4-9915-782bc7121717"
    }
  ]
}

Changes

  • 9c9e8ec96e98Revision changes
    • breaking

      removed the enum value aed of the request property /

    • breaking

      removed the enum value aud of the request property /

    • breaking

      removed the enum value cad of the request property /

    • breaking

      removed the enum value chf of the request property /

    • breaking

      removed the enum value cny of the request property /

    • breaking

      removed the enum value dkk of the request property /

    • breaking

      removed the enum value eur of the request property /

    • breaking

      removed the enum value gbp of the request property /

    • breaking

      removed the enum value hkd of the request property /

    • breaking

      removed the enum value jpy of the request property /

    • breaking

      removed the enum value mxn of the request property /

    • breaking

      removed the enum value sek of the request property /

    • breaking

      removed the enum value usd of the request property /

    • breaking

      removed the enum value zar of the request property /

    • warning

      added the new 1A 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 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 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 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 9G 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 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

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new AED enum value to the request property /

    • info

      added the new AUD enum value to the request property /

    • info

      added the new CAD enum value to the request property /

    • info

      added the new CHF enum value to the request property /

    • info

      added the new CNY enum value to the request property /

    • info

      added the new DKK enum value to the request property /

    • info

      added the new EUR enum value to the request property /

    • info

      added the new GBP enum value to the request property /

    • info

      added the new HKD enum value to the request property /

    • info

      added the new JPY enum value to the request property /

    • info

      added the new MXN enum value to the request property /

    • info

      added the new SEK enum value to the request property /

    • info

      added the new USD enum value to the request property /

    • info

      added the new ZAR enum value to the request property /

    • info

      added the optional property to the response with the status