Retrieve a transfer
Retrieve full transfer details for an individual transfer of a particular Moov account.
Payment rail-specific details are included in the source and destination. Read our transfers overview guide to learn more.
To access this endpoint using an access token
you’ll need to specify the /accounts/{accountID}/transfers.read scope.
 | 
 | 
 | 
 | 
{
  "amount": {
    "currency": "USD",
    "value": 32945
  },
  "createdOn": "2025-01-21T21:32:16Z",
  "description": "Transfer from card to wallet",
  "destination": {
    "account": {
      "accountID": "34233b72-780c-4a0d-8b08-cbbe23k878f8",
      "displayName": "Whole Body Fitness",
      "email": "john@wholebodyfitness.io"
    },
    "paymentMethodID": "3f9969cf-a1f3-4d83-8ddc-229a506651cf",
    "paymentMethodType": "moov-wallet",
    "wallet": {
      "walletID": "744b2e78-8cc8-4a6a-af42-611e3b844503"
    }
  },
  "source": {
    "account": {
      "accountID": "7e4b26c2-b399-49ef-8390-50e1ea44d550",
      "displayName": "Jules Jackson",
      "email": "jules@julesjackson.com"
    },
    "card": {
      "billingAddress": {
        "postalCode": "80301"
      },
      "bin": "400020",
      "brand": "Visa",
      "cardAccountUpdater": {},
      "cardID": "aefd5563-93c6-413c-875e-1bd0ebfc116d",
      "cardType": "credit",
      "cardVerification": {
        "accountName": {
          "firstName": "unavailable",
          "fullName": "unavailable",
          "lastName": "unavailable",
          "middleName": "unavailable"
        },
        "addressLine1": "unavailable",
        "cvv": "unavailable",
        "postalCode": "unavailable"
      },
      "domesticPullFromCard": "supported",
      "domesticPushToCard": "standard",
      "expiration": {
        "month": "01",
        "year": "28"
      },
      "fingerprint": "2f5d782ceef1c3bd31ed5...",
      "holderName": "Jules Jackson",
      "issuer": "Moov Visa Sandbox",
      "issuerCountry": "US",
      "lastFourCardNumber": "2000"
    },
    "cardDetails": {
      "confirmedOn": "2025-01-21T21:32:16.799681237Z",
      "dynamicDescriptor": "WhlBdy *Yoga 11-12",
      "status": "confirmed"
    },
    "paymentMethodID": "9506dbf6-4208-44c3-ad8a-e4431660e1f2",
    "paymentMethodType": "card-payment"
  },
  "status": "pending",
  "transferID": "d835gf30-4b19-4850-a9b2-c0624c41ecb3"
}Response headers
x-request-id
      string
      <uuid>
    
      required
    
  Response headers
x-request-id
      string
      <uuid>
    
      required
    
  Response headers
x-request-id
      string
      <uuid>
    
      required
    
  Response headers
x-request-id
      string
      <uuid>
    
      required
    
  Response headers
x-request-id
      string
      <uuid>
    
      required
    
  Response headers
x-request-id
      string
      <uuid>
    
      required
    
  Response headers
x-request-id
      string
      <uuid>
    
      required
    
  Headers
x-moov-version
      string
      
    
  API version
Specify an API version.
API versioning follows the format vYYYY.QQ.BB, where
YYYYis the yearQQis the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)BBis the build number, starting at.01, for subsequent builds in the same quarter.- For example, 
v2024.01.00is the initial release of the first quarter of 2024. 
- For example, 
 
The latest version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
v2024.01.00Path parameters
transferID
      string
      <uuid>
    
      required
    
  accountID
      string
      <uuid>
    
      required
    
  Response
amount
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
currency
        string
      
    
    
      
      
    
    
      required
    
    
    
      
        Pattern
      
    
  value
        integer<int64>
      
    
    
      
      
    
    
      required
    
    
    
  Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
createdOn
        string<date-time>
      
    
    
      
      
    
    
      required
    
    
    
  destination
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
account
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
accountID
        string
      
    
    
      
      
    
    
      required
    
    
    
  displayName
        string
      
    
    
      
      
    
    
      required
    
    
    
  
        string
      
    
    
      
      
    
    
      required
    
    
    
  paymentMethodID
        string
      
    
    
      
      
    
    
      required
    
    
    
  paymentMethodType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  moov-wallet,
    
      ach-debit-fund,
    
      ach-debit-collect,
    
      ach-credit-standard,
    
      ach-credit-same-day,
    
      rtp-credit,
    
      card-payment,
    
      push-to-card,
    
      pull-from-card,
    
      apple-pay,
    
      card-present-payment
    
  achDetails
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  initiated,
    
      originated,
    
      corrected,
    
      returned,
    
      completed,
    
      canceled
    
  traceNumber
        string
      
    
    
      
      
        <=15 characters
      
    
    
      required
    
    
    
  canceledOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  companyEntryDescription
        string
      
    
    
      
        [4 to 10] characters
      
    
    
    
    
  completedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  correctedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  correction
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
code
        string
      
    
    
      
      
    
    
    
    
  description
        string
      
    
    
      
      
    
    
    
    
  reason
        string
      
    
    
      
      
    
    
    
    
  debitHoldPeriod
        string<enum>
      
    
    
      
      
    
    
    
    
  no-hold,
    
      1-day,
    
      2-days
    
  failedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  initiatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  originatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  originatingCompanyName
        string
      
    
    
      
        [4 to 16] characters
      
    
    
    
    
  return
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
code
        string
      
    
    
      
      
    
    
    
    
  description
        string
      
    
    
      
      
    
    
    
    
  reason
        string
      
    
    
      
      
    
    
    
    
  returnedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  secCode
        string<enum>
      
    
    
      
      
    
    
    
    
  WEB,
    
      PPD,
    
      CCD,
    
      TEL
    
  applePay
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
brand
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  American Express,
    
      Discover,
    
      Mastercard,
    
      Visa,
    
      Unknown
    
  cardDisplayName
        string
      
    
    
      
      
    
    
      required
    
    
    
  User-friendly name of the tokenized card returned by Apple.
It usually contains the brand and the last four digits of the underlying card. There is no standard format.
cardType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  debit,
    
      credit,
    
      prepaid,
    
      unknown
    
  dynamicLastFour
        string
      
    
    
      
      
    
    
      required
    
    
    
  expiration
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
month
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  year
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  fingerprint
        string
      
    
    
      
      
        <=100 characters
      
    
    
      required
    
    
    
  issuerCountry
        string
      
    
    
      
      
    
    
    
    
  bankAccount
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
bankAccountID
        string<uuid>
      
    
    
      
      
    
    
      required
    
    
    
  bankAccountType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  checking,
    
      savings,
    
      general-ledger,
    
      loan
    
  bankName
        string
      
    
    
      
      
    
    
      required
    
    
    
  fingerprint
        string
      
    
    
      
      
        <=100 characters
      
    
    
      required
    
    
    
  Once the bank account is linked, we don’t reveal the full bank account number.
The fingerprint acts as a way to identify whether two linked bank accounts are the same.
holderName
        string
      
    
    
      
      
    
    
      required
    
    
    
  holderType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  individual,
    
      business
    
  lastFourAccountNumber
        string
      
    
    
      
      
    
    
      required
    
    
    
  routingNumber
        string
      
    
    
      
      
    
    
      required
    
    
    
  status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  new,
    
      verified,
    
      verificationFailed,
    
      pending,
    
      errored
    
  updatedOn
        string<date-time>
      
    
    
      
      
    
    
      required
    
    
    
  card
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
billingAddress
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
postalCode
        string
      
    
    
      
      
        <=10 characters
      
    
    
      required
    
    
    
  addressLine1
        string
      
    
    
      
      
        <=60 characters
      
    
    
    
    
  addressLine2
        string
      
    
    
      
      
        <=32 characters
      
    
    
    
    
  city
        string
      
    
    
      
      
        <=32 characters
      
    
    
    
    
  country
        string
      
    
    
      
      
        <=2 characters
      
    
    
    
    
  stateOrProvince
        string
      
    
    
      
      
        <=2 characters
      
    
    
    
    
  bin
        string
      
    
    
      
        [6 to 8] characters
      
    
    
      required
    
    
    
  brand
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  American Express,
    
      Discover,
    
      Mastercard,
    
      Visa,
    
      Unknown
    
  cardID
        string<uuid>
      
    
    
      
      
    
    
      required
    
    
    
  cardType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  debit,
    
      credit,
    
      prepaid,
    
      unknown
    
  cardVerification
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
accountName
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
firstName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  fullName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  lastName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  middleName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  addressLine1
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  cvv
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  postalCode
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  domesticPullFromCard
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  not-supported,
    
      supported,
    
      unknown
    
  domesticPushToCard
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  not-supported,
    
      standard,
    
      fast-funds,
    
      unknown
    
  expiration
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
month
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  year
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  fingerprint
        string
      
    
    
      
      
        <=100 characters
      
    
    
      required
    
    
    
  issuer
        string
      
    
    
      
      
    
    
      required
    
    
    
  issuerCountry
        string
      
    
    
      
      
    
    
      required
    
    
    
  lastFourCardNumber
        string
      
    
    
      
        4 characters
      
    
    
      required
    
    
    
  cardAccountUpdater
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
updateType
        string<enum>
      
    
    
      
      
    
    
    
    
  unspecified,
    
      account-closed,
    
      contact-cardholder,
    
      expiration-update,
    
      no-change,
    
      no-match,
    
      number-update
    
  updatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  cardOnFile
        boolean
      
    
    
      
      
    
    
    
    
  holderName
        string
      
    
    
      
      
    
    
    
    
  merchantAccountID
        string<uuid>
      
    
    
      
      
    
    
    
    
  cardDetails
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  initiated,
    
      confirmed,
    
      canceled,
    
      settled,
    
      failed,
    
      completed
    
  canceledOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  completedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  confirmedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  dynamicDescriptor
        string
      
    
    
      
        [4 to 22] characters
      
    
    
    
    
  failedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  failureCode
        string<enum>
      
    
    
      
      
    
    
    
    
  call-issuer,
    
      do-not-honor,
    
      processing-error,
    
      invalid-transaction,
    
      invalid-amount,
    
      no-such-issuer,
    
      reenter-transaction,
    
      cvv-mismatch,
    
      lost-or-stolen,
    
      insufficient-funds,
    
      invalid-card-number,
    
      invalid-merchant,
    
      expired-card,
    
      incorrect-pin,
    
      transaction-not-allowed,
    
      suspected-fraud,
    
      amount-limit-exceeded,
    
      velocity-limit-exceeded,
    
      revocation-of-authorization,
    
      card-not-activated,
    
      issuer-not-available,
    
      could-not-route,
    
      cardholder-account-closed,
    
      unknown-issue,
    
      duplicate-transaction
    
  feeProgram
        string
      
    
    
      
      
    
    
    
    
  initiatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  interchangeQualification
        string
      
    
    
      
      
    
    
    
      deprecated
    
    
  settledOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  transactionSource
        string<enum>
      
    
    
      
      
    
    
    
    
  Specifies the nature and initiator of a transaction.
Crucial for recurring and merchant-initiated transactions as per card scheme rules. Omit for customer-initiated e-commerce transactions.
first-recurring,
    
      recurring,
    
      unscheduled
    
  rtpDetails
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  initiated,
    
      completed,
    
      failed,
    
      accepted-without-posting
    
  acceptedWithoutPostingOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  completedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  failedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  failureCode
        string<enum>
      
    
    
      
      
    
    
    
    
  processing-error,
    
      invalid-account,
    
      account-closed,
    
      account-blocked,
    
      invalid-field,
    
      transaction-not-supported,
    
      limit-exceeded,
    
      invalid-amount,
    
      customer-deceased,
    
      other
    
  initiatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  networkResponseCode
        string
      
    
    
      
      
    
    
    
    
  wallet
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
walletID
        string<uuid>
      
    
    
      
      
    
    
      required
    
    
    
  source
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
account
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
accountID
        string
      
    
    
      
      
    
    
      required
    
    
    
  displayName
        string
      
    
    
      
      
    
    
      required
    
    
    
  
        string
      
    
    
      
      
    
    
      required
    
    
    
  paymentMethodID
        string
      
    
    
      
      
    
    
      required
    
    
    
  paymentMethodType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  moov-wallet,
    
      ach-debit-fund,
    
      ach-debit-collect,
    
      ach-credit-standard,
    
      ach-credit-same-day,
    
      rtp-credit,
    
      card-payment,
    
      push-to-card,
    
      pull-from-card,
    
      apple-pay,
    
      card-present-payment
    
  achDetails
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  initiated,
    
      originated,
    
      corrected,
    
      returned,
    
      completed,
    
      canceled
    
  traceNumber
        string
      
    
    
      
      
        <=15 characters
      
    
    
      required
    
    
    
  canceledOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  companyEntryDescription
        string
      
    
    
      
        [4 to 10] characters
      
    
    
    
    
  completedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  correctedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  correction
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
code
        string
      
    
    
      
      
    
    
    
    
  description
        string
      
    
    
      
      
    
    
    
    
  reason
        string
      
    
    
      
      
    
    
    
    
  debitHoldPeriod
        string<enum>
      
    
    
      
      
    
    
    
    
  no-hold,
    
      1-day,
    
      2-days
    
  failedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  initiatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  originatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  originatingCompanyName
        string
      
    
    
      
        [4 to 16] characters
      
    
    
    
    
  return
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
code
        string
      
    
    
      
      
    
    
    
    
  description
        string
      
    
    
      
      
    
    
    
    
  reason
        string
      
    
    
      
      
    
    
    
    
  returnedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  secCode
        string<enum>
      
    
    
      
      
    
    
    
    
  WEB,
    
      PPD,
    
      CCD,
    
      TEL
    
  applePay
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
brand
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  American Express,
    
      Discover,
    
      Mastercard,
    
      Visa,
    
      Unknown
    
  cardDisplayName
        string
      
    
    
      
      
    
    
      required
    
    
    
  User-friendly name of the tokenized card returned by Apple.
It usually contains the brand and the last four digits of the underlying card. There is no standard format.
cardType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  debit,
    
      credit,
    
      prepaid,
    
      unknown
    
  dynamicLastFour
        string
      
    
    
      
      
    
    
      required
    
    
    
  expiration
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
month
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  year
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  fingerprint
        string
      
    
    
      
      
        <=100 characters
      
    
    
      required
    
    
    
  issuerCountry
        string
      
    
    
      
      
    
    
    
    
  bankAccount
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
bankAccountID
        string<uuid>
      
    
    
      
      
    
    
      required
    
    
    
  bankAccountType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  checking,
    
      savings,
    
      general-ledger,
    
      loan
    
  bankName
        string
      
    
    
      
      
    
    
      required
    
    
    
  fingerprint
        string
      
    
    
      
      
        <=100 characters
      
    
    
      required
    
    
    
  Once the bank account is linked, we don’t reveal the full bank account number.
The fingerprint acts as a way to identify whether two linked bank accounts are the same.
holderName
        string
      
    
    
      
      
    
    
      required
    
    
    
  holderType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  individual,
    
      business
    
  lastFourAccountNumber
        string
      
    
    
      
      
    
    
      required
    
    
    
  routingNumber
        string
      
    
    
      
      
    
    
      required
    
    
    
  status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  new,
    
      verified,
    
      verificationFailed,
    
      pending,
    
      errored
    
  updatedOn
        string<date-time>
      
    
    
      
      
    
    
      required
    
    
    
  card
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
billingAddress
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
postalCode
        string
      
    
    
      
      
        <=10 characters
      
    
    
      required
    
    
    
  addressLine1
        string
      
    
    
      
      
        <=60 characters
      
    
    
    
    
  addressLine2
        string
      
    
    
      
      
        <=32 characters
      
    
    
    
    
  city
        string
      
    
    
      
      
        <=32 characters
      
    
    
    
    
  country
        string
      
    
    
      
      
        <=2 characters
      
    
    
    
    
  stateOrProvince
        string
      
    
    
      
      
        <=2 characters
      
    
    
    
    
  bin
        string
      
    
    
      
        [6 to 8] characters
      
    
    
      required
    
    
    
  brand
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  American Express,
    
      Discover,
    
      Mastercard,
    
      Visa,
    
      Unknown
    
  cardID
        string<uuid>
      
    
    
      
      
    
    
      required
    
    
    
  cardType
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  debit,
    
      credit,
    
      prepaid,
    
      unknown
    
  cardVerification
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
accountName
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
firstName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  fullName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  lastName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  middleName
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  addressLine1
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  cvv
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  postalCode
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  noMatch,
    
      match,
    
      notChecked,
    
      unavailable,
    
      partialMatch
    
  domesticPullFromCard
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  not-supported,
    
      supported,
    
      unknown
    
  domesticPushToCard
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  not-supported,
    
      standard,
    
      fast-funds,
    
      unknown
    
  expiration
        object
      
    
    
      
      
    
    
      required
    
    
    
  Show child attributes
month
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  year
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  fingerprint
        string
      
    
    
      
      
        <=100 characters
      
    
    
      required
    
    
    
  issuer
        string
      
    
    
      
      
    
    
      required
    
    
    
  issuerCountry
        string
      
    
    
      
      
    
    
      required
    
    
    
  lastFourCardNumber
        string
      
    
    
      
        4 characters
      
    
    
      required
    
    
    
  cardAccountUpdater
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
updateType
        string<enum>
      
    
    
      
      
    
    
    
    
  unspecified,
    
      account-closed,
    
      contact-cardholder,
    
      expiration-update,
    
      no-change,
    
      no-match,
    
      number-update
    
  updatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  cardOnFile
        boolean
      
    
    
      
      
    
    
    
    
  holderName
        string
      
    
    
      
      
    
    
    
    
  merchantAccountID
        string<uuid>
      
    
    
      
      
    
    
    
    
  cardDetails
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  initiated,
    
      confirmed,
    
      canceled,
    
      settled,
    
      failed,
    
      completed
    
  canceledOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  completedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  confirmedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  dynamicDescriptor
        string
      
    
    
      
        [4 to 22] characters
      
    
    
    
    
  failedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  failureCode
        string<enum>
      
    
    
      
      
    
    
    
    
  call-issuer,
    
      do-not-honor,
    
      processing-error,
    
      invalid-transaction,
    
      invalid-amount,
    
      no-such-issuer,
    
      reenter-transaction,
    
      cvv-mismatch,
    
      lost-or-stolen,
    
      insufficient-funds,
    
      invalid-card-number,
    
      invalid-merchant,
    
      expired-card,
    
      incorrect-pin,
    
      transaction-not-allowed,
    
      suspected-fraud,
    
      amount-limit-exceeded,
    
      velocity-limit-exceeded,
    
      revocation-of-authorization,
    
      card-not-activated,
    
      issuer-not-available,
    
      could-not-route,
    
      cardholder-account-closed,
    
      unknown-issue,
    
      duplicate-transaction
    
  feeProgram
        string
      
    
    
      
      
    
    
    
    
  initiatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  interchangeQualification
        string
      
    
    
      
      
    
    
    
      deprecated
    
    
  settledOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  transactionSource
        string<enum>
      
    
    
      
      
    
    
    
    
  Specifies the nature and initiator of a transaction.
Crucial for recurring and merchant-initiated transactions as per card scheme rules. Omit for customer-initiated e-commerce transactions.
first-recurring,
    
      recurring,
    
      unscheduled
    
  terminalCard
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
bin
        string
      
    
    
      
        [6 to 8] characters
      
    
    
    
    
  brand
        string<enum>
      
    
    
      
      
    
    
    
    
  American Express,
    
      Discover,
    
      Mastercard,
    
      Visa,
    
      Unknown
    
  cardType
        string<enum>
      
    
    
      
      
    
    
    
    
  debit,
    
      credit,
    
      prepaid,
    
      unknown
    
  entryMode
        string<enum>
      
    
    
      
      
    
    
    
    
  contactless
    
  expiration
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
month
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  year
        string
      
    
    
      
        2 characters
      
    
    
      required
    
    
    
  fingerprint
        string
      
    
    
      
      
        <=100 characters
      
    
    
    
    
  holderName
        string
      
    
    
      
      
    
    
    
    
  issuer
        string
      
    
    
      
      
    
    
    
    
  issuerCountry
        string
      
    
    
      
      
    
    
    
    
  lastFourCardNumber
        string
      
    
    
      
        4 characters
      
    
    
    
    
  transferID
        string<uuid>
      
    
    
      
      
    
    
    
    
  wallet
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
walletID
        string<uuid>
      
    
    
      
      
    
    
      required
    
    
    
  status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  created,
    
      pending,
    
      completed,
    
      failed,
    
      reversed,
    
      queued,
    
      canceled
    
  transferID
        string<uuid>
      
    
    
      
      
    
    
      required
    
    
    
  cancellations
        array
      
    
    
      
      
    
    
    
    
  Show child attributes
cancellationID
        string
      
    
    
      
      
    
    
    
    
  createdOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  status
        string<enum>
      
    
    
      
      
    
    
    
    
  pending,
    
      completed,
    
      failed
    
  completedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  description
        string
      
    
    
      
      
        <=128 characters
      
    
    
    
    
  disputedAmount
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
currency
        string
      
    
    
      
      
    
    
      required
    
    
    
      
        Pattern
      
    
  value
        integer<int64>
      
    
    
      
      
    
    
      required
    
    
    
  Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
disputes
        array
      
    
    
      
      
    
    
    
    
  Show child attributes
amount
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
currency
        string
      
    
    
      
      
    
    
      required
    
    
    
      
        Pattern
      
    
  value
        integer<int64>
      
    
    
      
      
    
    
      required
    
    
    
  Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
createdOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  disputeID
        string<uuid>
      
    
    
      
      
    
    
    
    
  facilitatorFee
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
markup
        integer<int64>
      
    
    
      
      
    
    
    
    
  markup or markupDecimal can be set.
    markupDecimal
        string
      
    
    
      
      
    
    
    
    
      
        Pattern
      
    
  markup, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
Only either markup or markupDecimal can be set. Set this field if you expect the fee to be in fractions of a cent.
    total
        integer<int64>
      
    
    
      
      
    
    
    
    
  total or totalDecimal can be set.
    totalDecimal
        string
      
    
    
      
      
    
    
    
    
      
        Pattern
      
    
  Same as total, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
Only either total or totalDecimal can be set. Set this field if you expect the fee to be in fractions of a cent.
failureReason
        string<enum>
      
    
    
      
      
    
    
    
    
  source-payment-error,
    
      destination-payment-error,
    
      wallet-insufficient-funds,
    
      rejected-high-risk,
    
      processing-error
    
  groupID
        string
      
    
    
      
      
    
    
    
    
  metadata
        object
      
    
    
      
      
    
    
    
    
  moovFee
        integer<int64>
      
    
    
      
      
    
    
    
    
  moovFeeDecimal
        string
      
    
    
      
      
    
    
    
    
  moovFee, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
    moovFeeDetails
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
moovProcessing
        string
      
    
    
      
      
    
    
      required
    
    
    
  cardScheme
        string
      
    
    
      
      
    
    
    
    
  discount
        string
      
    
    
      
      
    
    
    
    
  interchange
        string
      
    
    
      
      
    
    
    
    
  occurrenceID
        string
      
    
    
      
      
    
    
    
    
  refundedAmount
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
currency
        string
      
    
    
      
      
    
    
      required
    
    
    
      
        Pattern
      
    
  value
        integer<int64>
      
    
    
      
      
    
    
      required
    
    
    
  Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
refunds
        array
      
    
    
      
      
    
    
    
    
  Show child attributes
amount
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
currency
        string
      
    
    
      
      
    
    
      required
    
    
    
      
        Pattern
      
    
  value
        integer<int64>
      
    
    
      
      
    
    
      required
    
    
    
  Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
cardDetails
        object
      
    
    
      
      
    
    
    
    
  Show child attributes
status
        string<enum>
      
    
    
      
      
    
    
      required
    
    
    
  initiated,
    
      confirmed,
    
      settled,
    
      failed,
    
      completed
    
  completedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  confirmedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  failedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  failureCode
        string<enum>
      
    
    
      
      
    
    
    
    
  call-issuer,
    
      do-not-honor,
    
      processing-error,
    
      invalid-transaction,
    
      invalid-amount,
    
      no-such-issuer,
    
      reenter-transaction,
    
      cvv-mismatch,
    
      lost-or-stolen,
    
      insufficient-funds,
    
      invalid-card-number,
    
      invalid-merchant,
    
      expired-card,
    
      incorrect-pin,
    
      transaction-not-allowed,
    
      suspected-fraud,
    
      amount-limit-exceeded,
    
      velocity-limit-exceeded,
    
      revocation-of-authorization,
    
      card-not-activated,
    
      issuer-not-available,
    
      could-not-route,
    
      cardholder-account-closed,
    
      unknown-issue,
    
      duplicate-transaction
    
  initiatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  settledOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  createdOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  refundID
        string<uuid>
      
    
    
      
      
    
    
    
    
  status
        string<enum>
      
    
    
      
      
    
    
    
    
  created,
    
      pending,
    
      completed,
    
      failed
    
  updatedOn
        string<date-time>
      
    
    
      
      
    
    
    
    
  scheduleID
        string
      
    
    
      
      
    
    
    
    
  sweepID
        string