> ## Documentation Index > Fetch the complete documentation index at: https://docs.layerfi.com/llms.txt > Use this file to discover all available pages before exploring further. # Update payment > Update an invoice payment. Updates to information such as the amount or time will cause reversal of previous journal entries and creation of new entries. ## OpenAPI ````yaml patch /v1/businesses/{businessId}/invoices/payments/{paymentId} openapi: 3.0.1 info: title: API version: latest servers: [] security: - BearerAuth: [] tags: [] externalDocs: url: / paths: /v1/businesses/{businessId}/invoices/payments/{paymentId}: patch: tags: [] summary: Update payment description: >- Update an invoice payment. Updates to information such as the amount or time will cause reversal of previous journal entries and creation of new entries. operationId: business.invoices.payments.patch parameters: - name: businessId in: path description: The UUID of the business to update the invoice payment for. required: true schema: type: string - name: paymentId in: path description: The UUID of the invoice payment to update. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/PaymentPatchUpdate' responses: '200': description: OK. content: application/json: schema: $ref: '#/components/schemas/ApiInvoicePayment' '404': description: Business id or payment id is not found. content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: PaymentPatchUpdate: type: object properties: external_id: type: string nullable: true description: An optional external identifier for the payment. example: >- Unique ID of the invoice payment in an external system for linking and idempotency. paid_at: type: string format: date-time nullable: true description: Timestamp when the payment was completed. amount: type: integer format: int64 nullable: true description: Customer payment amount, in cents. fee: type: integer format: int64 nullable: true description: Fee paid by business for processing of payment in positive cents. additional_fees: type: array items: $ref: '#/components/schemas/PaymentFeeInput' nullable: true description: List of additional fees associated with this payment. method: $ref: '#/components/schemas/PaymentMethod' nullable: true description: Payment method. processor: type: string nullable: true description: >- Processor used to make the payment, if any. Any processor name can be provided and will be tracked. example: STRIPE payment_clearing_account_identifier: $ref: '#/components/schemas/AccountIdentifier' description: >- The the ledger account to use for the payment (overrides the default determined by the payment method). invoice_payments: type: array items: oneOf: - $ref: '#/components/schemas/CreateInvoicePaymentAllocation' description: Allocates a portion of the payment to a specific invoice. title: Invoice Payment Allocation - $ref: >- #/components/schemas/CreateInvoicePaymentAllocationToLedgerAccount description: >- Allocates a portion of the payment directly to a ledger account, rather than to an invoice. title: Ledger Account Allocation nullable: true description: >- Allocations of this payment towards invoices or ledger accounts. Setting these allocations will override any existing allocations. dedicated_refunds: type: array items: $ref: '#/components/schemas/CreateDedicatedRefundParams' nullable: true description: Dedicated refunds to associate with this invoice payment. tags: type: array items: $ref: '#/components/schemas/TagKeyValue' memo: type: string nullable: true description: >- Memo for any text you would like to associate with the invoice payment (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the invoice payment. Can be used to filter when listing invoice payments. description: >- An object containing a subset of Payment object fields used to update an existing Payment. ApiInvoicePayment: type: object properties: id: type: string format: uuid description: Unique identifier for the payment. external_id: type: string nullable: true description: >- Unique ID of the invoice payment in an external system for linking and idempotency. example: payment-1 at: type: string format: date-time description: Timestamp when the payment was completed. method: $ref: '#/components/schemas/PaymentMethod' description: Payment method. fee: type: integer format: int64 description: Fee paid by business for processing of payment in positive cents. prepayment_account: $ref: '#/components/schemas/AccountIdentifier' description: Identifier for the ledger account to use if this is a prepayment. payment_clearing_account: $ref: '#/components/schemas/SingleApiChartAccount' description: >- The the ledger account to use for the payment (overrides the default determined by the payment method), if specified. additional_fees: type: array items: $ref: '#/components/schemas/ApiInvoicePaymentFee' description: List of additional fees associated with this payment. amount: type: integer format: int64 description: Customer payment amount, in cents. processor: type: string nullable: true description: >- Processor used to make the payment, if any. Any processor name can be provided and will be tracked. example: STRIPE imported_at: type: string format: date-time description: Timestamp when the payment was imported into Layer. allocations: type: array items: oneOf: - $ref: '#/components/schemas/ApiInvoicePaymentAllocation' description: Allocates a portion of the payment to a specific invoice. title: Invoice Payment Allocation - $ref: >- #/components/schemas/ApiInvoicePaymentAllocationToLedgerAccount description: >- Allocates a portion of the payment directly to a ledger account, rather than to an invoice. title: Ledger Account Allocation discriminator: propertyName: type description: >- Allocations specify how a payment is distributed. A payment can include two types of allocations: `InvoicePaymentAllocation` (allocates to an invoice) and `InvoicePaymentAllocationToLedgerAccount` (allocates directly to a ledger account for overpayments or deposits). The sum of all allocation amounts must be less than or equal to the payment amount. refund_allocations: type: array items: $ref: '#/components/schemas/ApiRefundAllocation' description: Refund allocations associated with this invoice payment. example: [] payouts: type: array items: $ref: '#/components/schemas/ApiPayoutWithoutTransactions' description: Payouts associated with this payment. transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' description: List of tags associated with this transaction. example: [] memo: type: string nullable: true description: >- Memo for any text you would like to associate with the invoice payment (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the invoice payment. Can be used to filter when listing invoice payments. ApiError: type: object description: An error object returned in API error responses. properties: type: $ref: '#/components/schemas/ApiErrorType' description: >- A fixed category for the error, helpful for categorizing and processing errors. description: type: string description: A human-readable error description. error_enum: $ref: '#/components/schemas/ApiEnumErrorType' description: >- A stable, machine-readable identifier for programmatically handling specific error conditions. Only present for 4xx client errors—not included for 5xx server errors. Use this instead of parsing the description field, as enum values remain stable across API versions. nullable: true meta: type: object description: Optional additional information about the error. nullable: true required: - type - description PaymentFeeInput: type: object properties: fee_amount: type: integer format: int64 description: Amount of the fee in cents. description: type: string description: Description of the fee. account: $ref: '#/components/schemas/AccountIdentifier' description: >- [Account identifier](/api-reference/ledger/account-identifier) to which the fee should be allocated. is_passed_to_customer: type: boolean description: >- Whether or not the fee is passed to the customer. It is paid by the business otherwise. When calculating the outstanding balance on the invoice, only the portion of each payment allocation that is applied to the invoice (excluding pass-through fees) is considered. This allows customers to pay the invoice amount plus any pass-through fees without the invoice being considered overpaid. PaymentMethod: type: string enum: - CASH - CHECK - CREDIT_CARD - ACH - CREDIT_BALANCE - OTHER AccountIdentifier: oneOf: - $ref: '#/components/schemas/AccountId' description: ID of the account. title: Account ID - $ref: '#/components/schemas/AccountStableName' description: Stable name associated with the account. title: Account Stable Name CreateInvoicePaymentAllocation: type: object properties: invoice_id: type: string format: uuid description: >- Layer ID of the invoice to apply payment. Either the invoice_id or invoice_external_id must be provided. invoice_external_id: type: string format: uuid description: >- External ID of the invoice payment. Either the invoice_id or invoice_external_id must be provided. amount: type: integer format: int64 description: Amount paid towards this invoice in cents. tags: type: array items: $ref: '#/components/schemas/TagKeyValue' description: Tags to apply to the allocation. memo: type: string nullable: true description: >- Memo for any text you would like to associate with the invoice payment allocation (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the invoice payment allocation. CreateInvoicePaymentAllocationToLedgerAccount: type: object description: >- Input for allocating a portion of a payment directly to a ledger account, rather than to an invoice. This is useful for recording payments not associated with a specific invoice, such as overpayments or deposits. required: - account - amount properties: account: $ref: '#/components/schemas/AccountIdentifier' description: >- The [Account Identifier](/api-reference/ledger/account-identifier) of the ledger account to allocate to. The presence of this field distinguishes a ledger account allocation from an invoice allocation. amount: type: integer format: int64 description: Amount to allocate to this ledger account, in cents. tags: type: array items: $ref: '#/components/schemas/TagKeyValue' description: Tags to apply to the allocation. memo: type: string nullable: true description: Optional memo for the allocation. metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: User-visible identifier for the allocation. CreateDedicatedRefundParams: type: object properties: external_id: type: string description: >- Unique ID of the refund in your system for linking purposes. **Idempotency key**. example: '31415926535' account_identifier: $ref: '#/components/schemas/AccountIdentifier' nullable: true description: >- Optional account identifier to override what ledger account the dedicated refund comes out of. line_items: type: array items: $ref: '#/components/schemas/CreateCustomerRefundAllocationLineItemParams' nullable: true description: >- Detailed line items for the refund allocation. Use this for itemized refunds where you need to specify the exact amounts and accounts. completed_at: type: string format: date-time description: When the dedicated refund was given and paid. refund_processing_fee: type: integer format: int64 description: Fee charged to the business for processing the refund. method: $ref: '#/components/schemas/PaymentMethod' processor: type: string nullable: true refunded_payment_fees: type: array items: $ref: '#/components/schemas/RefundedPaymentFeeInput' description: >- List of fees associated with the payment for this dedicated refund. These are refunded from the payment processor rather than the business. tags: type: array items: $ref: '#/components/schemas/TagKeyValue' description: List of tags associated with this dedicated refund. memo: type: string nullable: true description: >- Memo for any text you would like to associate with the refund (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the refund. Can be used to filter when listing refunds. payment_clearing_account_identifier: $ref: '#/components/schemas/AccountIdentifier' nullable: true description: >- Optional account identifier to specify the clearing account for inferred refund payments. Only used when the system automatically generates a payment for the dedicated refund. TagKeyValue: type: object description: >- A TagKeyValue holds key=value data related to a tag. This is used when creating or updating taggable entities (transactions, invoices, etc.). properties: key: type: string description: The tag dimension key (e.g., "department", "project", "location"). example: department dimension_display_name: type: string nullable: true description: >- If the TagDimension doesn't exist, providing this value specifies the display name upon database insertion. Otherwise, it is left as null on the TagDimension. example: Department value: type: string description: The tag value (e.g., "sales", "marketing", "engineering"). example: sales value_display_name: type: string nullable: true description: >- If the TagValueDefinition doesn't exist, providing this value specifies the display name upon database insertion. Otherwise, it is left as null on the TagValueDefinition. example: Sales Department required: - key - value PlatformDefinedJson: type: object description: Arbitrary JSON data defined by the caller, with a 1KB size constraint. additionalProperties: true example: custom_field: value any valid json: below 1kb nested: meaning of life: 42 array: [] SingleApiChartAccount: type: object properties: id: $ref: '#/components/schemas/AccountIdentifier' name: type: string description: Name of the account. example: Current Assets account_number: type: string nullable: true description: Account number if configured. example: '4000' stable_name: $ref: '#/components/schemas/AccountStableName' normality: $ref: '#/components/schemas/BankTransactionDirection' account_type: $ref: '#/components/schemas/ApiLedgerAccountType' account_subtype: $ref: '#/components/schemas/ApiLedgerAccountSubtype' description: A single ledger account without nested children. ApiInvoicePaymentFee: type: object properties: fee_amount: type: integer format: int64 description: Amount of the fee in cents. description: type: string description: Description of the fee. account: $ref: '#/components/schemas/AccountIdentifier' description: Account to which the fee should be allocated. is_passed_to_customer: type: boolean description: >- Whether or not the fee is passed to the customer. It is paid by the business otherwise. ApiInvoicePaymentAllocation: type: object properties: invoice_id: type: string format: uuid description: ID of the invoice. payment_id: type: string format: uuid description: ID of the payment. amount: type: integer format: int64 description: >- Amount of the payment allocated towards this invoice. If this amount is the full payment amount, this payment was fully allocated towards this invoice. The amount cannot exceed the invoice total. amount_net_of_refunds: type: integer format: int64 description: Amount allocated after applying any refunds, in cents. transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' description: >- List of tags on the transaction associated with the payment allocation. memo: type: string nullable: true description: >- Memo for any text you would like to associate with the invoice payment allocation (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the invoice payment allocation. ApiInvoicePaymentAllocationToLedgerAccount: type: object description: >- Represents a portion of a payment allocated directly to a ledger account, rather than to a specific invoice. This is useful for recording payments that are not associated with a specific invoice, such as overpayments or deposits. properties: account_id: type: string format: uuid description: ID of the ledger account to which this payment is allocated. payment_id: type: string format: uuid description: ID of the payment this allocation applies from. amount: type: integer format: int64 description: Customer payment amount, in cents. amount_net_of_refunds: type: integer format: int64 description: Amount allocated after applying any refunds, in cents. memo: type: string nullable: true description: Optional memo for the allocation. metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format. reference_number: type: string nullable: true description: User-visible identifier for the allocation. transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' description: >- List of tags on the transaction associated with the payment allocation. ApiRefundAllocation: type: object properties: id: type: string format: uuid description: Unique identifier for the refund allocation. invoice_id: type: string format: uuid nullable: true description: ID of the invoice this allocation is associated with. amount: type: integer format: int64 description: Amount of the allocation in cents. account_identifier: $ref: '#/components/schemas/AccountIdentifier' description: >- Identifier of the ledger account for the refund allocation to apply to. nullable: true invoice_external_id: type: string nullable: true description: External ID of the invoice this allocation is associated with. invoice_line_item_id: type: string format: uuid nullable: true description: >- ID of the invoice line item this allocation is associated with. If specified, must not refer to a different invoice `invoice_external` or `invoice_id`. invoice_line_item_external_id: type: string nullable: true description: >- The external ID of the invoice line item to refund. If specified alongside `invoice_line_item_id`, they must refer to the same invoice line item. invoice_payment_id: type: string format: uuid nullable: true description: ID of the invoice payment this allocation is associated with. invoice_payment_external_id: type: string nullable: true description: >- External ID of the invoice payment this allocation is associated with. customer: $ref: '#/components/schemas/ApiCustomerData' transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' memo: type: string nullable: true description: >- Memo for any text you would like to associate with the refund allocation (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the refund allocation. ApiPayoutWithoutTransactions: type: object properties: id: type: string format: uuid description: Unique ID for the Payout. **Idempotency key.**. external_id: type: string nullable: true description: Unique ID of the payout in your system for linking purposes. example: payout-1234 business_id: type: string format: uuid description: ID of the Business that generated the payout. paid_out_amount: type: integer format: int64 description: The amount of the payout, in cents. fee: type: integer format: int64 description: The platform fee associated with the payout. processor: $ref: '#/components/schemas/PaymentProcessor' description: >- Processor used to make the payment, if any. Any processor name can be provided and will be tracked. example: STRIPE imported_at: type: string format: date-time description: Timestamp of when the payout was imported. completed_at: type: string format: date-time description: Timestamp of when the payout was completed. match: $ref: '#/components/schemas/ApiMatch' description: The transaction match associated with the payout. example: id: 6b0a3734-f4ef-4fb0-9fc1-3f59b0c1cf99 match_type: PAYOUT bank_transaction: type: Bank_Transaction_Data id: a703c8d6-cfe8-453d-a275-b92eacc6fc6e business_id: 738ec216-e8e5-48f2-b7f2-cdc89c96b3d4 source: STRIPE source_transaction_id: trxn_1sdOeLQiFAKE2LQBkcvrJw95f source_account_id: 738ec216-e154-48f2-1111-cdc89c96b3d4 imported_at: '2024-03-19T22:09:53.290591Z' date: '2024-03-06T06:06:40Z' direction: CREDIT amount: 87459 counterparty_name: null description: Payout (po_1OqnTHISISFAKEiTVBkCiyAERwm). account_name: Layer Banking categorization_status: MATCHED details: type: Payout_Match id: d224508b-b05e-41da-89de-0fbd8a573507 amount: 87459 date: '2024-03-06T00:00:00Z' description: Payout from STRIPE. adjustment: null transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' description: A list of tags associated with the payout. memo: type: string nullable: true description: >- Memo for any text you would like to associate with the payout (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the payout. Can be used to filter when listing payouts. ApiTag: type: object properties: id: type: string format: uuid description: ID for the tag. key: type: string description: Key for the tag. example: ExampleTagKey dimension_display_name: type: string nullable: true description: Display name for the tag dimension. value: type: string description: Value for the tag. example: ExampleTagValue value_display_name: type: string nullable: true description: Display name for the tag value definition. dimension_id: type: string format: uuid description: ID of the tag dimension this tag belongs to. definition_id: type: string format: uuid description: ID of the tag value definition. archived_at: type: string format: date-time nullable: true description: When the tag was archived. required: - id - key - value - dimension_id - definition_id ApiErrorType: type: string enum: - ResourceArchived - AuthFailure - Plaid - Stripe - InvalidState - ResourceNotFound - InvalidParameters - JsonSerialization - Unknown - BadRequest - PaginationCursor - Conflict - LedgerOperationFailed ApiEnumErrorType: type: string description: >- Stable enum values for programmatic error handling. Only present in 4xx error responses. enum: - AccessCodeInvalid - BalanceSheetDoesNotBalance - BalanceSheetMissingAccount - BankStatementParserError - BillStateError - BulkCategorizeFailure - BulkMatchFailure - BusinessTaskAlreadyCompleted - BusinessTaskDeleted - CalendlyOAuthError - CallBookingError - CantUpdateTransactionInCustomerPayout - CantUpdateTransactionInVendorPayout - CheckPayrollConfigNotFound - CheckPayrollServiceNotFound - ClerkUserAlreadyExists - ConflictingQueryParams - CustomAccountAlreadyExists - CustomTransactionCsvParsingError - CustomTransactionUploadFailure - CustomerPayoutInputFormatError - DoesNotMatchExistingEntity - EmptyBatchRequest - ExpenseParserError - ExternalAccountBalanceReconciliationError - ExternalIdConflict - InvalidCategory - InvalidEffectiveDate - InvalidLedgerOperation - InvalidMonthlyAverageRange - InvalidMultiPartRequest - InvalidPaginationCursor - InvalidPayload - InvoiceDeleted - InvoiceNotFound - InvoiceReferenceMismatch - InvoiceStateError - ManualRateLimit - MultipleTagKeyFiltersUnsupported - NoCognitoUserFound - NoOpeningBalanceFound - NotYetReconciled - OnePasswordApiError - OnePasswordItemNotFound - OnePasswordVaultNotFound - OpenAICategorizationError - PaymentLinkInvalid - PayrollStateError - PeriodIsClosed - PeriodNotClosed - PhoneNumberAlreadyRegistered - PlaidApiError - PlaidConnectionBroken - PlaidCreateLinkTokenError - PlaidCredentialsNotConfigured - PlaidExchangePublicTokenError - PlaidGetInstitutionByIdError - PlaidGetItemError - PlaidInvalidEnvironment - PlaidItemAlreadyExists - PlaidItemNotFound - PlaidProcessorApiError - PlaidUnlinkItemError - QueryParamFormat - QueryParamMissing - QuickbooksBrokenConnection - QuickbooksConnectionAlreadyExists - QuickbooksConnectionAlreadySyncing - QuickbooksConnectionMissing - QuickbooksConnectionNotActivated - QuickbooksInvalidRequest - QuickbooksInvalidState - QuickbooksNoMatchingAccount - QuickbooksNonPostingAccountType - QuickbooksNotConfigured - QuickbooksOAuthCallbackInvalid - QuickbooksOAuthError - QuickbooksTokenExpired - ResourceArchived - ScheduleCNotConfigured - SmsNotEnabled - SpecifiedBadRequest - SpecifiedIdNotFound - SplitTransactionError - StepEvaluationBadRequest - StripeConnectAccountIdNotFound - StripeCredentialsNotConfigured - StripeGetBalanceForConnectAccountFailure - StripeRedirectOrRefreshUrlNotConfigured - TagFilterNotFound - UnexpectedQueryParam - UnitAccountsInUse - WrongAnswerType AccountId: type: object required: - type - id properties: type: type: string enum: - AccountId description: Resource type. Value will be `AccountId`. example: AccountId id: type: string format: uuid description: ID of the account. AccountStableName: type: object required: - type - stable_name properties: type: type: string enum: - StableName description: Resource type. Value will be `StableName`. example: StableName stable_name: type: string example: CURRENT_ASSETS description: Stable name of the account. CreateCustomerRefundAllocationLineItemParams: type: object properties: external_id: type: string nullable: true description: An external identifier for the line item. amount: type: integer format: int64 description: The amount of this line item in cents. account_identifier: $ref: '#/components/schemas/AccountIdentifier' nullable: true description: Identifier of the ledger account for this line item. prepayment_account_identifier: $ref: '#/components/schemas/AccountIdentifier' nullable: true description: Identifier of the prepayment ledger account for this line item. tags: type: array items: $ref: '#/components/schemas/TagKeyValue' description: Tags to associate with the line item. memo: type: string nullable: true description: Memo for any text you would like to associate with the line item. metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the refund allocation line item. required: - amount description: Parameters for creating a refund allocation line item. RefundedPaymentFeeInput: type: object properties: account: $ref: '#/components/schemas/AccountIdentifier' description: Account to which the fee should be allocated. description: type: string nullable: true description: Description of the fee. fee_amount: type: integer format: int64 description: Amount of the fee in cents. required: - account - fee_amount description: Input parameters for a refunded payment fee. BankTransactionDirection: type: string enum: - CREDIT - DEBIT ApiLedgerAccountType: type: object properties: value: $ref: '#/components/schemas/LedgerAccountType' description: Type of the account. display_name: type: string description: Display name of the account type. example: Asset ApiLedgerAccountSubtype: type: object properties: value: $ref: '#/components/schemas/LedgerAccountSubtype' display_name: type: string description: Display name of the account subtype. example: Current Assets ApiCustomerData: type: object properties: id: type: string format: uuid description: Unique identifier for the customer. external_id: type: string description: >- Unique ID of the customer in your system for linking purposes. **Idempotency key**. example: '31415926535' individual_name: type: string nullable: true description: >- Full name of the individual customer or contact at a corporate customer. company_name: type: string nullable: true description: Name of the company customer. email: type: string nullable: true description: Email address of the customer. mobile_phone: type: string nullable: true description: Mobile phone number of the customer. office_phone: type: string nullable: true description: Office phone number of the customer. address_string: type: string nullable: true description: Address of the customer. memo: type: string nullable: true description: >- Memo for any text you would like to associate with the customer (for example, to display to end users). status: type: string description: 'Status of the customer. Possible values: `ACTIVE`, `ARCHIVED`.' example: ACTIVE transaction_tags: type: array items: $ref: '#/components/schemas/ApiTag' PaymentProcessor: type: string enum: - STRIPE - PAYPAL - SHOPIFY - ADYEN - RAINFOREST ApiMatch: type: object properties: id: type: string format: uuid description: Layer's UUID for the match. match_type: $ref: '#/components/schemas/MatchType' description: Type of the object to match. bank_transaction: $ref: '#/components/schemas/ApiBankTransactionInterface' details: $ref: '#/components/schemas/ApiMatchDetails' LedgerAccountType: type: string enum: - ASSET - LIABILITY - EQUITY - REVENUE - COGS - EXPENSE LedgerAccountSubtype: type: string enum: - BANK_ACCOUNTS - ACCOUNTS_RECEIVABLE - INVENTORY - PAYMENT_PROCESSOR_CLEARING_ACCOUNT - FIXED_ASSET - ACCUMULATED_DEPRECIATION - CASH - UNDEPOSITED_FUNDS - CURRENT_ASSET - NON_CURRENT_ASSET - PREPAID_EXPENSES - DEVELOPMENT_COSTS - LOANS_RECEIVABLE - INTANGIBLE_ASSET - ACCOUNTS_PAYABLE - CREDIT_CARD - TAXES_PAYABLE - INCOME_TAXES_PAYABLE - SALES_TAXES_PAYABLE - OTHER_TAXES_PAYABLE - PAYROLL_TAXES_PAYABLE - UNEARNED_REVENUE - PAYROLL_LIABILITY - PAYROLL_CLEARING - LINE_OF_CREDIT - TIPS - REFUND_LIABILITIES - UNDEPOSITED_OUTFLOWS - OUTGOING_PAYMENT_CLEARING_ACCOUNT - OTHER_CURRENT_LIABILITY - LOANS_PAYABLE - NOTES_PAYABLE - SHAREHOLDER_LOAN - NON_CURRENT_LIABILITY - CONTRIBUTIONS - DISTRIBUTIONS - COMMON_STOCK - PREFERRED_STOCK - ADDITIONAL_PAID_IN_CAPITAL - RETAINED_EARNINGS - ACCUMULATED_ADJUSTMENTS - OPENING_BALANCE_EQUITY - OTHER_EQUITY - SALES - UNCATEGORIZED_REVENUE - RETURNS_ALLOWANCES - DIVIDEND_INCOME - INTEREST_INCOME - OTHER_INCOME - COGS - OPERATING_EXPENSES - PAYROLL - TAXES_LICENSES - UNCATEGORIZED_EXPENSE - CHARITABLE_CONTRIBUTIONS - LOAN_EXPENSES - FINANCE_COSTS - INTEREST_EXPENSES - DEPRECIATION - AMORTIZATION - BAD_DEBT - OTHER_EXPENSES MatchType: type: string enum: - TRANSFER - INVOICE_PAYMENT - PAYOUT ApiBankTransactionInterface: type: object required: - id - amount - date properties: id: type: string format: uuid description: Layer's UUID for the bank transaction. business_id: type: string format: uuid description: UUID of the business the transaction is for. source: $ref: '#/components/schemas/TransactionSource' description: Source of the bank transaction. source_transaction_id: type: string description: >- External transaction ID from the source platform (e.g, Plaid transaction ID). example: g4DlKyjXqGH3Kp5XlaWMtwLRrE4Z9AiE8B4Ko source_account_id: type: string description: >- External account ID from the source platform (e.g, Plaid account ID). example: Aaoy8G7VXZHVeqNoL1GvcmkPdqpLRWi9NArdG imported_at: type: string format: date-time description: Timestamp when the transaction was imported. date: type: string format: date-time description: Timestamp when the transaction was created. direction: $ref: '#/components/schemas/BankTransactionDirection' description: Direction of the transaction. amount: type: integer format: int64 description: Amount of the transaction, in cents. counterparty_name: type: string nullable: true description: Name of the transaction counterparty. example: WeWork description: type: string nullable: true description: Description of the transaction. example: WeWork monthly rent payment account_name: type: string nullable: true description: Name of the bank account. example: Plaid Checking categorizationStatus: $ref: '#/components/schemas/CategorizationStatus' description: The status of the transaction’s categorization in Layer’s systems. memo: type: string nullable: true description: >- Memo for any text you would like to associate with the bank transaction (for example, to display to end users). metadata: $ref: '#/components/schemas/PlatformDefinedJson' nullable: true description: Arbitrary custom metadata in JSON format with a size limit of 1KB. reference_number: type: string nullable: true description: >- Any (typically user-visible) identifier you would like to associate with the bank transaction. Can be used to filter when listing bank transactions. ApiMatchDetails: type: object required: - id - amount - date properties: id: type: string format: uuid description: Layer's ID for the match. amount: type: integer format: int64 description: Monetary amount of the matched transaction, in cents. date: type: string format: date-time description: Date that the matched transaction occurred. description: type: string nullable: true description: Description of the match. example: Transfer from SavingsAccount to CheckingAccount TransactionSource: type: string enum: - UNIT - PLAID - API - STRIPE - CUSTOM CategorizationStatus: type: string enum: - PENDING - READY_FOR_INPUT - CATEGORIZED - SPLIT - LAYER_REVIEW - JOURNALING - MATCHED securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ````