> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://beta-docs.payabli.com/api-reference/tokenstorage/get-a-payment-method/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://beta-docs.payabli.com/_mcp/server.

# Get tokenized method details

GET https://api-sandbox.payabli.com/api/TokenStorage/{methodId}

Retrieves details for a saved payment method.

Reference: https://beta-docs.payabli.com/api-reference/tokenstorage/get-a-payment-method

## Authentication

- `requestToken` header (required) — API Key authentication via header

## Servers

- `https://api-sandbox.payabli.com/api` (Sandbox, default)
- `https://api.payabli.com/api` (Production)

## Request

### Path parameters

- `methodId` (string, required) — The saved payment method ID.

### Query parameters

- `cardExpirationFormat` (integer, optional, default: 0) — Format for card expiration dates in the response. Accepted values: - 0: default, no formatting. Expiration dates are returned in the format they're saved in. - 1: MMYY - 2: MM/YY
- `includeTemporary` (boolean, optional, default: false) — When `true`, the request will include temporary tokens in the search and return details for a matching temporary token. The default behavior searches only for permanent tokens.

## Response

### 200

Success

- `isSuccess` (boolean, optional) — Boolean indicating whether the operation was successful. A `true` value indicates success. A `false` value indicates failure.
- `responseData` (GetMethodResponseResponseData, optional)
- `responseText` (string, optional) — Response text for operation: 'Success' or 'Declined'.

## Errors

### 400 Bad Request Error

Bad request/ invalid data

- `any`

### 401 Unauthorized Error

Unauthorized request.

- `any`

### 500 Internal Server Error

Internal API Error

- `any`

### 503 Service Unavailable Error

Database connection error

- `isSuccess` (boolean, optional) — Boolean indicating whether the operation was successful. A `true` value indicates success. A `false` value indicates failure.
- `responseData` (map from string to any, optional) — The object containing the response data.
- `responseText` (string, optional) — Response text for operation: 'Success' or 'Declined'.

## Types

### GetMethodResponseResponseData

- `aba` (string, optional) — Bank routing number
- `achHolderType` (enum, optional, default: personal) — The bank's accountholder type: personal or business.
  - Allowed values: `personal`, `business`
- `achSecCode` (string, optional) — Standard Entry Class (SEC) code is a a three letter code that describes how an ACH payment was authorized. Supported values are: - PPD (Prearranged Payment and Deposit) - Used for credits or debits where an accountholder authorizes a company to initiate either a single or recurring transaction to their personal bank account. Common examples include direct deposit of payroll, mortgage payments, or utility bills. This is the default value for subscription payments. - WEB (Internet-Initiated/Mobile Entry) - Used for debit entries when authorization is obtained from an accountholder via the internet or a wireless network. Common examples are online bill payments, ecommerce purchases, and mobile app payments where the consumer enters their banking information online. - TEL (Telephone-Initiated Entry) - Used for one-time debit entries where authorization is obtained from a consumer via telephone. Common examples are phone-based purchases or bill payments where the consumer provides their banking information over the phone. - CCD (Corporate Credit or Debit) - Used for fund transfers between business accounts. This code is specifically for business-to-business transactions. Common examples include vendor payments and other business-to-business payments.
- `bin` (string, optional) — The bank identification number (BIN)
- `binData` (BinData, optional) — Object containing information related to the card. This object is `null` unless the payment method is card. If the payment method is Apple Pay, the binData will be related to the DPAN (device primary account number), not the card connected to Apple Pay.
- `customers` (list of GetMethodResponseResponseDataCustomersItem, optional)
- `descriptor` (string, optional) — When the method is a card, this field displays card brand. When the method is ACH, this field displays the account type for ACH (checking or savings).
- `expDate` (string, optional) — Expiration date for card in stored method in format MM/YY
- `holderName` (string, optional) — Account holder name in stored method
- `idPmethod` (string, optional) — The stored payment method's identifier in Payabli
- `lastUpdated` (datetime, optional) — Timestamp for last update of stored method, in UTC
- `maskedAccount` (string, optional) — Masked card or bank account used in transaction. In the case of Apple Pay, this is a masked DPAN (device primary account number).
- `method` (string, optional) — Method of payment: 'card' or 'ach'
- `methodType` (string, optional) — The payment method's token type
- `postalCode` (string, optional) — The payment method postal code

### BinData

Object containing information related to the card. This object is `null` unless the payment method is card. If the payment method is Apple Pay, the binData will be related to the DPAN (device primary account number), not the card connected to Apple Pay.

- `binCardBrand` (string, optional) — The card brand. For example, Visa, Mastercard, American Express, Discover.
- `binCardCategory` (string, optional) — The category of the card, which indicates the card product. For example: Standard, Gold, Platinum, etc. The binCardCategory for prepaid cards is marked `PREPAID`.
- `binCardIssuer` (string, optional) — The name of the financial institution that issued the card.
- `binCardIssuerCountry` (string, optional) — The issuing financial institution's country name.
- `binCardIssuerCountryCodeA2` (string, optional) — The issuing financial institution's two-character ISO country code. See [this resource](https://www.iso.org/obp/ui/#search) for a list of codes.
- `binCardIssuerCountryNumber` (double, optional) — The issuing financial institution's ISO standard numeric country code. See [this resource](https://www.iso.org/obp/ui/#search) for a list of codes.
- `binCardType` (string, optional) — The type of card: Credit or Debit.
- `binMatchedLength` (double, optional) — The number of characters from the beginning of the card number that were matched against a Bank Identification Number (BIN) or the Card Range table.

### GetMethodResponseResponseDataCustomersItem

- `additionalData` (map from string to map from string to any, optional) — Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. If you are using [custom identifiers](/developer-guides/entities-custom-identifiers), pass those in this object. Example usage: ```json { "additionalData": { "key1": "value1", "key2": "value2", "key3": "value3" } } ```
- `balance` (double, optional) — Customer's current balance
- `billingAddress1` (string, optional) — Billing address.
- `billingAddress2` (string, optional) — Additional line for the billing address.
- `billingCity` (string, optional) — Billing city.
- `billingCountry` (string, optional) — Billing address country.
- `billingEmail` (string, optional) — Email address.
- `billingPhone` (string, optional) — Phone number.
- `billingState` (string, optional) — Billing state. Must be 2-letter state code for address in US.
- `billingZip` (string, optional) — Customer's billing ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".
- `company` (string, optional) — Customer's company name.
- `created` (datetime, optional) — Creation timestamp
- `customerConsent` (map from string to any, optional) — Customer consent information
- `customerId` (long, optional) — The Payabli-generated unique ID for the customer.
- `customerNumber` (string, optional) — User-provided unique identifier for the customer. This is typically the customer ID from your own system.
- `customerStatus` (integer, optional) — Status code for the customer
- `customerSummary` (CustomerSummaryRecord, optional)
- `customerUsername` (string, optional) — Username of the customer
- `externalPaypointID` (string, optional) — A custom identifier for the paypoint, if applicable. Like `entrypoint` is the Payabli identifier for the merchant, `externalPaypointId` is a custom field you can use to include the merchant's ID from your own systems.
- `firstName` (string, optional) — Customer/Payor first name.
- `identifierFields` (list of string, optional) — List of fields acting as customer identifiers, to be used instead of CustomerNumber.
- `lastName` (string, optional) — Customer/Payor last name.
- `lastUpdated` (datetime, optional) — Last update timestamp
- `mfa` (boolean, optional) — Multi-factor authentication status
- `mfaMode` (integer, optional) — MFA mode setting
- `pageindentifier` (string, optional) — Auxiliary validation used internally by payment pages and components.
- `parentOrgId` (integer, optional) — Parent organization ID
- `parentOrgName` (string, optional) — The name of the parent organization.
- `paypointDbaname` (string, optional) — The alternate or common name that this business is doing business under usually referred to as a DBA name.
- `paypointEntryname` (string, optional) — The paypoint entryname the customer is associated with
- `paypointLegalname` (string, optional) — Business legal name.
- `shippingAddress1` (string, optional) — The shipping address.
- `shippingAddress2` (string, optional) — Additional line for shipping address.
- `shippingCity` (string, optional) — Shipping city.
- `shippingCountry` (string, optional) — Shipping address country.
- `shippingState` (string, optional) — Shipping state or province.
- `shippingZip` (string, optional) — Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".
- `snData` (map from string to any, optional) — Social network data
- `snIdentifier` (string, optional) — Social network identifier
- `snProvider` (string, optional) — Social network provider
- `storedMethods` (list of MethodQueryRecords, optional) — List of payment methods associated to the customer
- `subscriptions` (list of SubscriptionQueryRecords, optional) — List of subscriptions associated to the customer
- `timeZone` (integer, optional) — Customer's timezone

### CustomerSummaryRecord

- `numberofTransactions` (integer, optional) — Number total of transactions or payments
- `recentTransactions` (list of TransactionQueryRecords, optional) — List of more recent 5 transactions belonging to the customer
- `totalAmountTransactions` (double, optional) — Total amount in transactions
- `totalNetAmountTransactions` (double, optional) — Total net amount in transactions

### MethodQueryRecords

- `bin` (string, optional) — The bank identification number (BIN). Null when method is ACH.
- `binData` (BinData, optional) — Object containing information related to the card. This object is `null` unless the payment method is card. If the payment method is Apple Pay, the binData will be related to the DPAN (device primary account number), not the card connected to Apple Pay.
- `descriptor` (string, optional) — When the method is a card, this field displays card brand. When the method is ACH, this field displays the account type for ACH (checking or savings).
- `expDate` (string, optional) — Expiration date associated to the method (only for card) in format MMYY.
- `holderName` (string, optional) — Account holder name for the method.
- `idPmethod` (string, optional) — Method internal ID
- `lastUpdated` (datetime, optional) — Date of last update
- `maskedAccount` (string, optional) — Masked card or bank account used in transaction. In the case of Apple Pay, this is a masked DPAN (device primary account number).
- `method` (string, optional) — Type of payment vehicle: **ach** or **card**

### SubscriptionQueryRecords

- `CreatedAt` (datetime, optional) — Timestamp of when the subscription ws created, in UTC.
- `Customer` (QueryTransactionPayorData, optional)
- `EndDate` (datetime, optional) — The subscription's end date.
- `EntrypageId` (long, optional) — If applicable, the internal reference ID to the payment page capturing the payment.
- `ExternalPaypointID` (string, optional) — A custom identifier for the paypoint, if applicable. Like `entrypoint` is the Payabli identifier for the merchant, `externalPaypointId` is a custom field you can use to include the merchant's ID from your own systems.
- `FeeAmount` (double, optional) — Fee applied to the subscription.
- `Frequency` (string, optional) — The subscription's frequency.
- `IdSub` (long, optional) — The subscription's ID.
- `InvoiceData` (BillData, optional)
- `LastRun` (datetime, optional) — The last time the subscription was processed.
- `LastUpdated` (datetime, optional) — The last date and time the subscription was updated.
- `LeftCycles` (integer, optional) — The number of cycles the subscription has left.
- `Method` (string, optional) — The subscription's payment method.
- `NetAmount` (double, optional) — The subscription amount, minus any fees.
- `NextDate` (datetime, optional) — The next date the subscription will be processed.
- `ParentOrgName` (string, optional) — The name of the parent organization.
- `PaymentData` (QueryPaymentData, optional)
- `PaypointDbaname` (string, optional) — The paypoint's DBA name.
- `PaypointEntryname` (string, optional) — The paypoint's entryname.
- `PaypointId` (long, optional) — The paypoint's ID. Note that this is different than the entryname.
- `PaypointLegalname` (string, optional) — The paypoint's legal name.
- `PlanId` (integer, optional) — Payment plan ID.
- `Source` (string, optional) — Custom identifier to indicate the transaction or request source.
- `StartDate` (datetime, optional) — The subscription start date.
- `SubEvents` (list of GeneralEvents, optional) — Events associated with the subscription.
- `SubStatus` (integer, optional) — The subscription's status. - 0: Paused - 1: Active
- `TotalAmount` (double, optional) — The subscription amount, including any fees.
- `TotalCycles` (integer, optional) — The total number of cycles the subscription is set to run.
- `UntilCancelled` (boolean, optional) — When `true`, the subscription has no explicit end date and will run until canceled.

### TransactionQueryRecords

- `AchHolderType` (enum, optional, default: personal) — The bank's accountholder type: personal or business.
  - Allowed values: `personal`, `business`
- `AchSecCode` (string, optional) — Standard Entry Class (SEC) code is a a three letter code that describes how an ACH payment was authorized. Supported values are: - PPD (Prearranged Payment and Deposit) - Used for credits or debits where an accountholder authorizes a company to initiate either a single or recurring transaction to their personal bank account. Common examples include direct deposit of payroll, mortgage payments, or utility bills. This is the default value for subscription payments. - WEB (Internet-Initiated/Mobile Entry) - Used for debit entries when authorization is obtained from an accountholder via the internet or a wireless network. Common examples are online bill payments, ecommerce purchases, and mobile app payments where the consumer enters their banking information online. - TEL (Telephone-Initiated Entry) - Used for one-time debit entries where authorization is obtained from a consumer via telephone. Common examples are phone-based purchases or bill payments where the consumer provides their banking information over the phone. - CCD (Corporate Credit or Debit) - Used for fund transfers between business accounts. This code is specifically for business-to-business transactions. Common examples include vendor payments and other business-to-business payments.
- `BatchAmount` (double, optional) — Batch amount.
- `BatchNumber` (string, optional) — Batch number.
- `CfeeTransactions` (list of QueryCFeeTransaction, optional) — Service Fee or sub-charge transaction associated to the main transaction.
- `ConnectorName` (string, optional) — Connector used for transaction.
- `Customer` (QueryTransactionPayorData, optional)
- `DeviceId` (string, optional) — Identifier of registered cloud device used in the transaction.
- `EntrypageId` (long, optional) — If applicable, the internal reference ID to the payment page capturing the payment.
- `ExternalProcessorInformation` (string, optional) — Processor information, used for troubleshooting and reporting. This field contains a value when the API key used to make the request has management permissions.
- `FeeAmount` (double, optional) — Service fee or sub-charge applied.
- `GatewayTransId` (string, optional) — Internal identifier used for processing.
- `InvoiceData` (BillData, optional)
- `Method` (string, optional) — Payment method used: card, ach, or wallet.
- `NetAmount` (double, optional) — Net amount paid.
- `Operation` (string, optional) — The transaction's operation.
- `OrderId` (string, optional) — Custom identifier for the transaction.
- `OrgId` (long, optional) — ID of immediate parent organization.
- `ParentOrgName` (string, optional) — The name of the parent organization.
- `PaymentData` (QueryPaymentData, optional)
- `PaymentTransId` (string, optional) — Unique Transaction ID.
- `PayorId` (long, optional) — Unique ID for customer linked to the transaction.
- `PaypointDbaname` (string, optional) — Paypoint's DBA name.
- `PaypointEntryname` (string, optional) — Paypoint's entryname.
- `PaypointId` (long, optional) — InternalId for paypoint.
- `PaypointLegalname` (string, optional) — Paypoint's legal name.
- `PendingFeeAmount` (double, optional) — The difference between the configured pass-through fee and the fee amount sent in the request. When transfering funds, Payabli uses this field to deduct the fee difference and transfer the correct amount to the merchant. When a paypoint is set up to absorb fees, and the pass-through fee sent with the request is less than the configured amount, the difference must be covered by the merchant. See [Fee Configuration](/guides/passthrough-fees#fee-configuration) to learn more about pass-through fee settings.
- `RefundId` (long, optional) — Identifier of refund transaction linked to this payment.
- `ResponseData` (QueryResponseData, optional) — The transaction's response data.
- `ReturnedId` (long, optional) — Identifier of return/chargeback transaction linked to this payment.
- `ScheduleReference` (long, optional) — Reference to the subscription that originated the transaction.
- `SettlementStatus` (integer, optional) — Settlement status for transaction. See [the docs](/references/money-in-statuses#payment-funding-status) for a full reference.
- `Source` (string, optional) — Custom identifier to indicate the transaction or request source.
- `splitFundingInstructions` (list of SplitFundingContent, optional) — Split funding instructions for the transaction. The total amount of the splits must match the total amount of the transaction.
- `TotalAmount` (double, optional) — Transaction total amount (including service fee or sub-charge)
- `TransactionEvents` (list of QueryTransactionEvents, optional) — Events associated with this transaction.
- `TransactionTime` (datetime, optional) — Transaction date and time, in UTC.
- `TransAdditionalData` (any, optional)
- `TransStatus` (integer, optional) — Status of transaction. See [the docs](/references/money-in-statuses#money-in-transaction-status) for a full reference.

### QueryTransactionPayorData

- `AdditionalData` (string, optional) — Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. Example usage: ```json { "additionalData": { "key1": "value1", "key2": "value2", "key3": "value3" } } ```
- `BillingAddress1` (string, optional) — Customer's billing address.
- `BillingAddress2` (string, optional) — Additional line for Customer's billing address.
- `BillingCity` (string, optional) — Customer's billing city.
- `BillingCountry` (string, optional) — Customer's billing country.
- `BillingEmail` (string, optional) — Customer's email address.
- `BillingPhone` (string, optional) — Customer's phone number.
- `BillingState` (string, optional) — Customer's billing state. Must be 2-letter state code for address in US.
- `BillingZip` (string, optional) — Customer's billing ZIP code.
- `CompanyName` (string, optional) — Customer's company name.
- `CreatedAt` (datetime, optional) — Timestamp of when record was created, in UTC.
- `customerId` (long, optional) — The Payabli-generated unique ID for the customer.
- `CustomerId` (long, optional) — The Payabli-generated unique ID for the customer.
- `CustomerNumber` (string, optional) — User-provided unique identifier for the customer. This is typically the customer ID from your own system.
- `customerStatus` (integer, optional) — Customer Status. Possible values: - `-99` Deleted - `0` Inactive - `1` Active - `85` Locked (typically due to multiple failed login attempts)
- `FirstName` (string, optional) — Customer/Payor first name.
- `Identifiers` (list of any, optional) — Array of field names to be used as identifiers.
- `LastName` (string, optional) — Customer/Payor last name.
- `ShippingAddress1` (string, optional) — The shipping address.
- `ShippingAddress2` (string, optional) — Additional line for shipping address.
- `ShippingCity` (string, optional) — Shipping city.
- `ShippingCountry` (string, optional) — Shipping address country.
- `ShippingState` (string, optional) — Shipping state or province.
- `ShippingZip` (string, optional) — Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".

### BillData

- `AdditionalData` (string, optional) — Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. Example usage: ```json { "additionalData": { "key1": "value1", "key2": "value2", "key3": "value3" } } ```
- `attachments` (list of FileContent, optional) — Array of `fileContent` objects with attached documents. Max upload size is 30 MB.
- `company` (string, optional) — Company name of the recipient of the invoice.
- `discount` (double, optional) — Discount applied to the invoice.
- `dutyAmount` (double, optional) — Duty amount.
- `firstName` (string, optional) — First name of the recipient of the invoice.
- `freightAmount` (double, optional) — Freight/shipping amount.
- `frequency` (enum, optional) — Frequency of scheduled invoice.
  - Allowed values: `one-time`, `weekly`, `every2weeks`, `every6months`, `monthly`, `every3months`, `annually`
- `invoiceAmount` (double, optional) — Invoice total amount.
- `invoiceDate` (date, optional) — Invoice date in any of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.
- `invoiceDueDate` (date, optional) — Invoice due date in one of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.
- `invoiceEndDate` (date, optional) — Indicate the date to finish a scheduled invoice cycle (`invoiceType`` = 1) in any of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.
- `invoiceNumber` (string, optional) — Invoice number. Identifies the invoice under a paypoint.
- `invoiceStatus` (integer, optional) — Status for invoice. The accepted status values are: - 0 draft - 1 active - 2 partially paid - 4 paid/complete - 99 cancelled
- `invoiceType` (integer, optional) — Type of invoice. Only `0` for one-time invoices is currently supported.
- `items` (list of BillItem, optional) — Array of line items included in the invoice.
- `lastName` (string, optional) — Last name of the recipient of the invoice.
- `notes` (string, optional) — Notes included in the invoice.
- `paymentTerms` (enum, optional) — Payment terms for invoice. If no terms are defined, then reponse data for this field defaults to `N30`.
  - Allowed values: `PIA`, `CIA`, `UR`, `NET10`, `NET20`, `NET30`, `NET45`, `NET60`, `NET90`, `EOM`, `MFI`, `5MFI`, `10MFI`, `15MFI`, `20MFI`, `2/10NET30`, `UF`, `10UF`, `20UF`, `25UF`, `50UF`
- `purchaseOrder` (string, optional) — Purchase order number.
- `shippingAddress1` (string, optional) — The shipping address.
- `shippingAddress2` (string, optional) — Additional line for shipping address.
- `shippingCity` (string, optional) — Shipping city.
- `shippingCountry` (string, optional) — Shipping address country.
- `shippingEmail` (string, optional) — Shipping recipient's contact email address.
- `shippingFromZip` (string, optional) — Sender shipping ZIP code.
- `shippingPhone` (string, optional) — Recipient phone number.
- `shippingState` (string, optional) — Shipping state or province.
- `shippingZip` (string, optional) — Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".
- `summaryCommodityCode` (string, optional) — Commodity code.
- `tax` (double, optional) — Tax rate in percent applied to the invoice.
- `termsConditions` (string, optional) — Custom terms and conditions included in the invoice.

### QueryPaymentData

- `AccountExp` (string, optional) — Expiration date of card used in transaction.
- `accountId` (string, optional) — Custom identifier for payment connector.
- `AccountType` (string, optional) — Bank account type or card brand.
- `AccountZip` (string, optional) — ZIP code for card used in transaction.
- `binData` (BinData, optional) — Object containing information related to the card. This object is `null` unless the payment method is card. If the payment method is Apple Pay, the binData will be related to the DPAN (device primary account number), not the card connected to Apple Pay.
- `HolderName` (string, optional) — Account holder name for the method.
- `Initiator` (string, optional) — **Strongly recommended** The cardholder-initiated transaction (CIT) or merchant-initiated transaction (MIT) indicator for the transaction. If you don't specify a value, Payabli defaults to `merchant`. Available values: - `payor`: For cardholder-initiated transactions - `merchant`: For merchant-initiated transactions See [Understanding CIT and MIT Indicators](/guides/money-in-cit-mit) for more information.
- `MaskedAccount` (string, optional) — Masked card or bank account used in transaction. In the case of Apple Pay, this is a masked DPAN (device primary account number).
- `orderDescription` (string, optional) — Text description of the transaction.
- `paymentDetails` (PaymentDetail, optional) — Details about the payment.
- `Sequence` (string, optional) — The order of the transaction for cardholder-initiated transaction (CIT) and merchant-initiated transaction (MIT) purposes. This field is automatically detected and populated by Payabli. Available values: - `first`: The first use of the payment method. This is almost always a cardholder-initiated transaction. - `subsequent`: For merchant-initiated transactions after the first use of the payment method. See [Understanding CIT and MIT Indicators](/guides/money-in-cit-mit) for more information.
- `SignatureData` (string, optional)
- `StoredId` (string, optional) — Identifier of stored payment method used in transaction.
- `StoredMethodUsageType` (string, optional) — **Strongly recommended** The usage type for the stored method, used for merchant-initiated transactions (MIT). If you don't specify a value, Payabli defaults to `unscheduled`. Available values: - `unscheduled`: This type is used for transactions that are one-time or otherwise not pre-scheduled. - `subscription`: This type is used for subscription payments. For example, monthly rental fees or ongoing service subscriptions. - `recurring`: This type is used for recurring payments that occur per a set plan. For example, splitting an HOA special assessment over 6 monthly payments. See [Understanding CIT and MIT Indicators](/guides/money-in-cit-mit) for more information.

### GeneralEvents

- `description` (string, optional) — Event description.
- `eventTime` (datetime, optional) — Event timestamp, in UTC.
- `extraData` (map from string to any, optional) — Extra data.
- `refData` (string, optional) — Reference data.
- `source` (string, optional) — The event source.

### QueryCFeeTransaction

- `cFeeTransid` (string, optional)
- `feeAmount` (double, optional)
- `operation` (string, optional)
- `refundId` (long, optional)
- `responseData` (map from string to any, optional)
- `settlementStatus` (integer, optional)
- `transactionTime` (datetime, optional) — Timestamp when transaction was submitted, in UTC.
- `transStatus` (integer, optional)

### QueryResponseData

The transaction's response data.

- `authcode` (string, optional) — Authorization code for the transaction.
- `avsresponse` (string, optional) — Text code describing the result for address validation (applies only for card transactions).
- `avsresponse_text` (string, optional) — Text code describing the result for address validation (applies only for card transactions).
- `cvvresponse` (string, optional) — Text code describing the result for CVV validation (applies only for card transactions).
- `cvvresponse_text` (string, optional) — Text code describing the result for CVV validation (applies only for card transactions).
- `emv_auth_response_data` (string, optional) — EMV authorization response data, applicable for card transactions.
- `orderid` (string, optional) — Custom identifier for the transaction.
- `response` (string, optional) — Response text for operation: 'Success' or 'Declined'.
- `response_code` (string, optional) — Internal result code processing the transaction. Value 1 indicates successful operation, values 2 and 3 indicate errors.
- `response_code_text` (string, optional) — Text describing the result. If resultCode = 1, will return 'Approved' or a general success message. If resultCode = 2 or 3, will contain the cause of the decline.
- `responsetext` (string, optional) — Text describing the result. If resultCode = 1, will return 'Approved' or a general success message. If resultCode = 2 or 3, will contain the cause of the decline.
- `transactionid` (string, optional) — The transaction identifier in Payabli.
- `type` (string, optional) — Type of transaction or operation.

### SplitFundingContent

- `accountId` (string, optional) — The accountId for the account the split should be sent to.
- `amount` (double, optional) — Amount from the transaction to sent to this recipient.
- `description` (string, optional) — A description for the split.
- `recipientEntryPoint` (string, optional) — The entrypoint the split should be sent to.

### QueryTransactionEvents

- `EventData` (QueryTransactionEventsEventData, optional) — Any data associated to the event received from processor. Contents vary by event type.
- `EventTime` (datetime, optional) — Date and time of event.
- `TransEvent` (string, optional) — Event descriptor. See [TransEvent Reference](/references/transevents) for more details.

### FileContent

Contains details about a file. See See [fileObject Object Model](/api-reference/schemas/filecontent) for a complete reference. Max upload size is 30 MB.

- `fContent` (string, optional) — Content of file, Base64-encoded Ignored if furl is specified. Max upload size is 30 MB.
- `filename` (string, optional) — The name of the attached file.
- `ftype` (enum, optional) — The MIME type of the file (if content is provided)
  - Allowed values: `pdf`, `doc`, `docx`, `jpg`, `jpeg`, `png`, `gif`, `txt`
- `furl` (string, optional) — Optional url provided to show or download the file remotely

### BillItem

- `itemCost` (double, required) — Item or product price per unit.
- `itemCategories` (list of string, optional) — Array of tags classifying item or product.
- `itemCommodityCode` (string, optional) — Item or product commodity code. Max length of 250 characters.
- `itemDescription` (string, optional) — Item or product description. Max length of 250 characters.
- `itemMode` (integer, optional) — Internal class of item or product: value '0' is only for invoices , '1' for bills and, '2' common for both.
- `itemProductCode` (string, optional) — Item or product code. Max length of 250 characters.
- `itemProductName` (string, optional) — Item or product name. Max length of 250 characters.
- `itemQty` (integer, optional) — Quantity of item or product.
- `itemTaxAmount` (double, optional) — Tax amount applied to item or product.
- `itemTaxRate` (double, optional) — Tax rate applied to item or product.
- `itemTotalAmount` (double, optional) — Total amount in item or product.
- `itemUnitOfMeasure` (string, optional) — Unit of measurement. Max length of 100 characters.

### PaymentDetail

Details about the payment.

- `totalAmount` (double, required) — Total amount to be charged. If a service fee is sent, then this amount should include the service fee."
- `categories` (list of PaymentCategories, optional) — Array of payment categories/line items describing the amount to be paid **Note**: These categories are for information only and are not validated against the total amount provided.
- `checkImage` (map from string to any, optional) — Object containing image of paper check.
- `checkNumber` (string, optional) — A check number to be used in the ach transaction. **Required** for payment method = 'check'.
- `currency` (string, optional) — Currency code ISO-4217. If not code is provided the currency in the paypoint setting is taken. Default is **USD**.
- `serviceFee` (double, optional) — Service fee to be deducted from the total amount. This amount must be a number, percentages aren't accepted. If you are using a percentage-based fee schedule, you must calculate the value manually.
- `splitFunding` (list of SplitFundingContent, optional) — Split funding instructions for the transaction. See [Split a Transaction](/developer-guides/money-in-split-funding) for more.

### QueryTransactionEventsEventData

Any data associated to the event received from processor. Contents vary by event type.

### PaymentCategories

- `amount` (double, required) — Price/cost per unit of item or category.
- `label` (string, required) — Name of item or category.
- `description` (string, optional) — Description of item or category
- `qty` (integer, optional, default: 1) — Quatity of item or category

## Examples

### Example tokenstorage GET with card payment method

**Response**

```json
{
  "isSuccess": true,
  "responseData": {
    "aba": "",
    "achHolderType": "personal",
    "achSecCode": "achSecCode",
    "bin": "401288",
    "binData": {
      "binCardBrand": "VISA",
      "binCardCategory": "CLASSIC",
      "binCardIssuer": "CHASE",
      "binCardIssuerCountry": "UNITED STATES",
      "binCardIssuerCountryCodeA2": "US",
      "binCardIssuerCountryNumber": 840,
      "binCardType": "CREDIT",
      "binMatchedLength": 6
    },
    "customers": [
      {
        "additionalData": {
          "key1": {
            "key": "value"
          },
          "key2": {
            "key": "value"
          },
          "key3": {
            "key": "value"
          }
        },
        "balance": 250,
        "billingPhone": "1234567890",
        "company": "Bluesky Tech Inc",
        "created": "2023-06-01T14:30:00Z",
        "customerId": 1456,
        "customerNumber": "CS789",
        "customerStatus": 1,
        "customerUsername": "Marcus",
        "identifierFields": [
          "firstname",
          "email"
        ],
        "lastUpdated": "2024-12-15T09:45:32Z",
        "mfa": true,
        "mfaMode": 1,
        "parentOrgId": 5,
        "parentOrgName": "TechCorp",
        "paypointDbaname": "Bluesky Tech",
        "paypointEntryname": "45782932fcc",
        "paypointLegalname": "Bluesky Technologies LLC",
        "shippingAddress1": "Suite 500",
        "shippingCity": "San Francisco",
        "shippingCountry": "US",
        "shippingState": "CA",
        "shippingZip": "94105",
        "timeZone": -8
      }
    ],
    "descriptor": "visa",
    "expDate": "0926",
    "holderName": "Marcus Chen",
    "idPmethod": "81f7fde1-dd8b-4892-b2e1-cd60dd91f6b4-XXXC",
    "lastUpdated": "2025-01-15T16:30:22Z",
    "maskedAccount": "4XXXXXXX2345",
    "method": "card",
    "methodType": "Single Merchant",
    "postalCode": "94105"
  },
  "responseText": "Success"
}
```

**SDK Code**

```python Example tokenstorage GET with card payment method
import requests

url = "https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678"

querystring = {"cardExpirationFormat":"1","includeTemporary":"false"}

headers = {"requestToken": "<apiKey>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript Example tokenstorage GET with card payment method
const url = 'https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false';
const options = {method: 'GET', headers: {requestToken: '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Example tokenstorage GET with card payment method
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("requestToken", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Example tokenstorage GET with card payment method
require 'uri'
require 'net/http'

url = URI("https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["requestToken"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java Example tokenstorage GET with card payment method
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false")
  .header("requestToken", "<apiKey>")
  .asString();
```

```php Example tokenstorage GET with card payment method
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false', [
  'headers' => [
    'requestToken' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Example tokenstorage GET with card payment method
using RestSharp;

var client = new RestClient("https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false");
var request = new RestRequest(Method.GET);
request.AddHeader("requestToken", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Example tokenstorage GET with card payment method
import Foundation

let headers = ["requestToken": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Example tokenstorage GET with ACH payment method

**Response**

```json
{
  "isSuccess": true,
  "responseData": {
    "aba": "021000021",
    "achHolderType": "personal",
    "achSecCode": "PPD",
    "bin": "",
    "customers": [
      {
        "additionalData": {
          "key1": {
            "key": "value"
          },
          "key2": {
            "key": "value"
          },
          "key3": {
            "key": "value"
          }
        },
        "balance": 250,
        "billingPhone": "1234567890",
        "company": "Bluesky Tech Inc",
        "created": "2023-06-01T14:30:00Z",
        "customerId": 1456,
        "customerNumber": "CS789",
        "customerStatus": 1,
        "customerUsername": "Marcus",
        "identifierFields": [
          "firstname",
          "email"
        ],
        "lastUpdated": "2024-12-15T09:45:32Z",
        "mfa": true,
        "mfaMode": 1,
        "parentOrgId": 5,
        "parentOrgName": "TechCorp",
        "paypointDbaname": "Bluesky Tech",
        "paypointEntryname": "45782932fcc",
        "paypointLegalname": "Bluesky Technologies LLC",
        "shippingAddress1": "Suite 500",
        "shippingCity": "San Francisco",
        "shippingCountry": "US",
        "shippingState": "CA",
        "shippingZip": "94105",
        "snIdentifier": "null",
        "snProvider": "google",
        "timeZone": -8
      }
    ],
    "descriptor": "Checking",
    "expDate": "",
    "holderName": "Marcus Chen",
    "idPmethod": "81f7fde1-dd8b-4892-b2e1-cd60dd91f6b4-XXXX",
    "lastUpdated": "2025-01-15T16:30:22Z",
    "maskedAccount": "8XXXXXX8654",
    "method": "ach",
    "methodType": "Single Merchant",
    "postalCode": ""
  },
  "responseText": "Success"
}
```

**SDK Code**

```python Example tokenstorage GET with ACH payment method
import requests

url = "https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678"

querystring = {"cardExpirationFormat":"1","includeTemporary":"false"}

headers = {"requestToken": "<apiKey>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript Example tokenstorage GET with ACH payment method
const url = 'https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false';
const options = {method: 'GET', headers: {requestToken: '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Example tokenstorage GET with ACH payment method
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("requestToken", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Example tokenstorage GET with ACH payment method
require 'uri'
require 'net/http'

url = URI("https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["requestToken"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java Example tokenstorage GET with ACH payment method
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false")
  .header("requestToken", "<apiKey>")
  .asString();
```

```php Example tokenstorage GET with ACH payment method
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false', [
  'headers' => [
    'requestToken' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Example tokenstorage GET with ACH payment method
using RestSharp;

var client = new RestClient("https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false");
var request = new RestRequest(Method.GET);
request.AddHeader("requestToken", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Example tokenstorage GET with ACH payment method
import Foundation

let headers = ["requestToken": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api-sandbox.payabli.com/api/TokenStorage/32-8877drt00045632-678?cardExpirationFormat=1&includeTemporary=false")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

> If you're a software company, you're a payments company™