API documentation
User
Tenant
Feature
Entitlement
User & permissions
Settings
- Settings
- Media
- Webhook
- Notification
Payment
- Payment Method
- Transaction
- SEPA XML
- Open Banking
- Bank Account Transaction
Customer
- Customer
- Customer Address
- Customer Email
- Customer Settings
- Customer Otp
Billing
- Invoice
- Invoice Position Item
- Billing Run
Dunning
- Dunning Document
- Dunning Rule
Subscription
- Subscription
- Subscription Item
- Subscription Measurement
- Billing Group
Offers
- Offer
- Offer Recipient
- Offer Template
Catalogue
- Unit
- Measurement
- Product
- Product Family
- Price Plan
- Coupon
Checkout
- Checkout Link
- Cart
Accounting
Get a bank account transaction assignment
Get a bank account transaction assignment, which shows the match between a bank account transaction and an invoice.
curl -X GET \
/payment/bank-account-transaction-assignments/{id} \
--header "Authorization: Bearer <token>"
{
"id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
"invoice": {
"id": "00000000-0000-0000-0000-000000000000",
"customer": {},
"paymentMethod": {
"id": "<string>",
"gatewayName": "wallet",
"type": "sepa_debit",
"referenceId": "<string>",
"default": true,
"status": "active",
"source": "api",
"enabled": true,
"name": "<string>",
"data": [
"<string>"
],
"creationDate": "2023-11-07T05:31:56Z",
"expirationDate": "2023-11-07T05:31:56Z",
"sepaMandate": {},
"card": {
"brand": "Visa",
"last4": "4242",
"expMonth": 12,
"expYear": 2022,
"cardHolder": "Max Mustermann"
},
"sepaDebit": {
"iban": "DE8937*********3232",
"bic": "COBADEFFXXX",
"mandateReference": "MNDT-2021-123456",
"signingDate": "2021-01-01T00:00:00+00:00"
},
"paypal": {
"email": "max@mustermann.de",
"billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
}
},
"referencedInvoice": {},
"type": "TYPE_INVOICE",
"currencyCode": "EUR",
"number": "RE-0000000001",
"status": "STATUS_DRAFT",
"creationDate": "2023-11-07T05:31:56Z",
"finalizationDate": "2023-11-07T05:31:56Z",
"dueDate": "2023-11-07T05:31:56Z",
"lastReminderDate": "2023-11-07T05:31:56Z",
"lastSentAt": "2023-11-07T05:31:56Z",
"dunningLevel": 123,
"dunningStatus": "none",
"payDate": "2023-11-07T05:31:56Z",
"invoiceAddress": "<any>",
"internalNote": "This invoice is with a special discount.",
"title": "<string>",
"introduction": "<string>",
"closing": "<string>",
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"file": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"xmlFile": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"positions": [
{
"id": {},
"position": 123,
"quantity": 1,
"unit": {
"id": {},
"name": "Stück"
},
"unitPrice": {},
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"discountPercentage": 10,
"name": "My subscription product",
"description": "* my subscription product",
"taxGroup": {
"id": "00000000-0000-0000-0000-000000000000",
"internalDescription": "19%",
"reverseChargeType": "REVERSE_CHARGE",
"type": "standard"
},
"tax": {
"id": "00000000-0000-0000-0000-000000000000",
"description": "19%",
"code": "19",
"rate": 19
},
"type": "product",
"parent": {},
"group": {
"id": "ad8a3b9e-5b0a-4e1a-9c1a-0b9b2b8b0b0b",
"ranking": 1,
"name": "Subscription #12345"
},
"createdAt": "2020-01-01T00:00:00+00:00",
"product": "https://example.com/",
"subscriptionItem": "https://example.com/",
"serviceDateFrom": "2020-01-01T00:00:00+00:00",
"serviceDateTo": "2020-01-01T00:00:00+00:00"
}
],
"applicatedExchangeRates": [
{
"sourceCurrencyCode": "EUR",
"destinationCurrencyCode": "CHF",
"exchangeRate": "1.135",
"exchangeRateDate": "2023-11-07T05:31:56Z"
}
],
"eInvoiceType": "<any>",
"leitwegId": "1234567890123",
"customFields": {
"field1": "value1",
"field2": "value2"
},
"serviceDateFrom": "2023-11-07T05:31:56Z",
"serviceDateTo": "2023-11-07T05:31:56Z",
"unpaidAmount": {},
"usageBreakdownUrl": "<string>",
"cancellationDocument": {
"number": "R2021-0001",
"id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
},
"dunningDisabled": true,
"sourceType": "<any>"
},
"transaction": {
"id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
"customer": {},
"type": "payment",
"paymentMethod": {
"id": "<string>",
"gatewayName": "wallet",
"type": "sepa_debit",
"referenceId": "<string>",
"default": true,
"status": "active",
"source": "api",
"enabled": true,
"name": "<string>",
"data": [
"<string>"
],
"creationDate": "2023-11-07T05:31:56Z",
"expirationDate": "2023-11-07T05:31:56Z",
"sepaMandate": {},
"card": {
"brand": "Visa",
"last4": "4242",
"expMonth": 12,
"expYear": 2022,
"cardHolder": "Max Mustermann"
},
"sepaDebit": {
"iban": "DE8937*********3232",
"bic": "COBADEFFXXX",
"mandateReference": "MNDT-2021-123456",
"signingDate": "2021-01-01T00:00:00+00:00"
},
"paypal": {
"email": "max@mustermann.de",
"billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
}
},
"gateway": "<any>",
"status": "<any>",
"description": "Payment for invoice #123",
"documentNumber": "123456789",
"currencyCode": "EUR",
"amount": 500,
"refundedAmount": 123,
"chargedAmount": 500,
"feeAmount": 50,
"createdAt": "2023-11-07T05:31:56Z",
"paidAt": "2023-11-07T05:31:56Z",
"failReason": "The payment method was not valid.",
"authorized": true,
"refundable": true,
"processing": true,
"captured": true,
"invoice": {
"id": "00000000-0000-0000-0000-000000000000",
"customer": {},
"paymentMethod": {
"id": "<string>",
"gatewayName": "wallet",
"type": "sepa_debit",
"referenceId": "<string>",
"default": true,
"status": "active",
"source": "api",
"enabled": true,
"name": "<string>",
"data": [
"<string>"
],
"creationDate": "2023-11-07T05:31:56Z",
"expirationDate": "2023-11-07T05:31:56Z",
"sepaMandate": {},
"card": {
"brand": "Visa",
"last4": "4242",
"expMonth": 12,
"expYear": 2022,
"cardHolder": "Max Mustermann"
},
"sepaDebit": {
"iban": "DE8937*********3232",
"bic": "COBADEFFXXX",
"mandateReference": "MNDT-2021-123456",
"signingDate": "2021-01-01T00:00:00+00:00"
},
"paypal": {
"email": "max@mustermann.de",
"billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
}
},
"referencedInvoice": {},
"type": "TYPE_INVOICE",
"currencyCode": "EUR",
"number": "RE-0000000001",
"status": "STATUS_DRAFT",
"creationDate": "2023-11-07T05:31:56Z",
"finalizationDate": "2023-11-07T05:31:56Z",
"dueDate": "2023-11-07T05:31:56Z",
"lastReminderDate": "2023-11-07T05:31:56Z",
"lastSentAt": "2023-11-07T05:31:56Z",
"dunningLevel": 123,
"dunningStatus": "none",
"payDate": "2023-11-07T05:31:56Z",
"invoiceAddress": "<any>",
"internalNote": "This invoice is with a special discount.",
"title": "<string>",
"introduction": "<string>",
"closing": "<string>",
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"file": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"xmlFile": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"positions": [
{
"id": {},
"position": 123,
"quantity": 1,
"unit": {
"id": {},
"name": "Stück"
},
"unitPrice": {},
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"discountPercentage": 10,
"name": "My subscription product",
"description": "* my subscription product",
"taxGroup": {
"id": "00000000-0000-0000-0000-000000000000",
"internalDescription": "19%",
"reverseChargeType": "REVERSE_CHARGE",
"type": "standard"
},
"tax": {
"id": "00000000-0000-0000-0000-000000000000",
"description": "19%",
"code": "19",
"rate": 19
},
"type": "product",
"parent": {},
"group": {
"id": "ad8a3b9e-5b0a-4e1a-9c1a-0b9b2b8b0b0b",
"ranking": 1,
"name": "Subscription #12345"
},
"createdAt": "2020-01-01T00:00:00+00:00",
"product": "https://example.com/",
"subscriptionItem": "https://example.com/",
"serviceDateFrom": "2020-01-01T00:00:00+00:00",
"serviceDateTo": "2020-01-01T00:00:00+00:00"
}
],
"applicatedExchangeRates": [
{
"sourceCurrencyCode": "EUR",
"destinationCurrencyCode": "CHF",
"exchangeRate": "1.135",
"exchangeRateDate": "2023-11-07T05:31:56Z"
}
],
"eInvoiceType": "<any>",
"leitwegId": "1234567890123",
"customFields": {
"field1": "value1",
"field2": "value2"
},
"serviceDateFrom": "2023-11-07T05:31:56Z",
"serviceDateTo": "2023-11-07T05:31:56Z",
"unpaidAmount": {},
"usageBreakdownUrl": "<string>",
"cancellationDocument": {
"number": "R2021-0001",
"id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
},
"dunningDisabled": true,
"sourceType": "<any>"
},
"referenceId": "ch_1J3AJ2"
},
"amount": {},
"fee": {},
"matchedAt": "2023-11-07T05:31:56Z"
}
Authorizations
Value for the Authorization header parameter.
Path Parameters
BankAccountTransactionAssignment identifier
Response
"ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c"
The unique identifier of the invoice.
"00000000-0000-0000-0000-000000000000"
The customer of the invoice.
The payment method which should be used to fullfill the payment of the invoice.
wallet
, sepa_debit
, stripe
, fake_provider
, paypal
, bank_transfer
, go_cardless
, testing
sepa_debit
, card
, paypal
, bank_transfer
, wallet
, fake_provider
active
, action_required
, expired
, revoked
, gateway_unconfigured
"active"
checkout
, customerfront
, api
, add_link
"api"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
The card data of the payment method, if the type is "card"
The brand of the card
"Visa"
The last 4 digits of the card
"4242"
The expiration month of the card
12
The expiration year of the card
2022
The card holder name
"Max Mustermann"
The sepa mandate data of the payment method, if the type is "sepa_debit"
The iban of the sepa mandate
"DE8937*********3232"
The bic of the sepa mandate
"COBADEFFXXX"
The mandate reference of the sepa mandate
"MNDT-2021-123456"
The signing date of the sepa mandate
"2021-01-01T00:00:00+00:00"
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The unique identifier of the invoice.
"00000000-0000-0000-0000-000000000000"
The customer of the invoice.
The payment method which should be used to fullfill the payment of the invoice.
wallet
, sepa_debit
, stripe
, fake_provider
, paypal
, bank_transfer
, go_cardless
, testing
sepa_debit
, card
, paypal
, bank_transfer
, wallet
, fake_provider
active
, action_required
, expired
, revoked
, gateway_unconfigured
"active"
checkout
, customerfront
, api
, add_link
"api"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
The card data of the payment method, if the type is "card"
The brand of the card
"Visa"
The last 4 digits of the card
"4242"
The expiration month of the card
12
The expiration year of the card
2022
The card holder name
"Max Mustermann"
The sepa mandate data of the payment method, if the type is "sepa_debit"
The iban of the sepa mandate
"DE8937*********3232"
The bic of the sepa mandate
"COBADEFFXXX"
The mandate reference of the sepa mandate
"MNDT-2021-123456"
The signing date of the sepa mandate
"2021-01-01T00:00:00+00:00"
The paypal data of the payment method, if the type is "paypal"
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The unique identifier of the invoice.
"00000000-0000-0000-0000-000000000000"
The customer of the invoice.
The payment method which should be used to fullfill the payment of the invoice.
wallet
, sepa_debit
, stripe
, fake_provider
, paypal
, bank_transfer
, go_cardless
, testing
sepa_debit
, card
, paypal
, bank_transfer
, wallet
, fake_provider
active
, action_required
, expired
, revoked
, gateway_unconfigured
"active"
checkout
, customerfront
, api
, add_link
"api"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
The card data of the payment method, if the type is "card"
The sepa mandate data of the payment method, if the type is "sepa_debit"
The paypal data of the payment method, if the type is "paypal"
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The unique identifier of the invoice.
"00000000-0000-0000-0000-000000000000"
The customer of the invoice.
The payment method which should be used to fullfill the payment of the invoice.
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The type of the invoice.
TYPE_INVOICE
, TYPE_CREDIT
, TYPE_REFUND
, TYPE_REMINDER
, TYPE_CANCEL
, TYPE_DUNNING
"TYPE_INVOICE"
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
"EUR"
The document id of the invoice. This will be generated, when the invoice will be finalized.
"RE-0000000001"
STATUS_DRAFT
, STATUS_PAID
, STATUS_CANCELLED
, STATUS_CLOSED
, STATUS_REFUNDED
, STATUS_REMINDED
, STATUS_UNPAID
, STATUS_NEW
, STATUS_FINALIZING
reminder
, dunning
, none
"none"
The invoice address of the invoice.
The notice of the invoice.
"This invoice is with a special discount."
The net amount of the invoice.
The total net discount amount of the invoice.
The xml representation of the invoice in EN16931 or x-Rechnung format.
The positions of the invoice.
The applicated exchange rates of the invoice, fetched from the european central bank.
The einvoice generated xml file format.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
"1234567890123"
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
{ "field1": "value1", "field2": "value2" }
The earliest service date of all positions.
The latest service date of all positions.
Public url to view the detailed usage breakdown of this invoice.
The referenced cancellation document.
{
"number": "R2021-0001",
"id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
}
Dunning is disabled for this invoice.
Where the invoice was created from.
Possible values:
cart
: The invoice was created from a cart.subscription
: The invoice was created from a subscription billing run.manual
: The invoice was created by a user.
The type of the invoice.
TYPE_INVOICE
, TYPE_CREDIT
, TYPE_REFUND
, TYPE_REMINDER
, TYPE_CANCEL
, TYPE_DUNNING
"TYPE_INVOICE"
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
"EUR"
The document id of the invoice. This will be generated, when the invoice will be finalized.
"RE-0000000001"
STATUS_DRAFT
, STATUS_PAID
, STATUS_CANCELLED
, STATUS_CLOSED
, STATUS_REFUNDED
, STATUS_REMINDED
, STATUS_UNPAID
, STATUS_NEW
, STATUS_FINALIZING
reminder
, dunning
, none
"none"
The invoice address of the invoice.
The notice of the invoice.
"This invoice is with a special discount."
The net amount of the invoice.
The total net discount amount of the invoice.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The xml representation of the invoice in EN16931 or x-Rechnung format.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The positions of the invoice.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The applicated exchange rates of the invoice, fetched from the european central bank.
"EUR"
"CHF"
"1.135"
The einvoice generated xml file format.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
"1234567890123"
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
{ "field1": "value1", "field2": "value2" }
The earliest service date of all positions.
The latest service date of all positions.
Public url to view the detailed usage breakdown of this invoice.
The referenced cancellation document.
Dunning is disabled for this invoice.
Where the invoice was created from.
Possible values:
cart
: The invoice was created from a cart.subscription
: The invoice was created from a subscription billing run.manual
: The invoice was created by a user.
The type of the invoice.
TYPE_INVOICE
, TYPE_CREDIT
, TYPE_REFUND
, TYPE_REMINDER
, TYPE_CANCEL
, TYPE_DUNNING
"TYPE_INVOICE"
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
"EUR"
The document id of the invoice. This will be generated, when the invoice will be finalized.
"RE-0000000001"
STATUS_DRAFT
, STATUS_PAID
, STATUS_CANCELLED
, STATUS_CLOSED
, STATUS_REFUNDED
, STATUS_REMINDED
, STATUS_UNPAID
, STATUS_NEW
, STATUS_FINALIZING
reminder
, dunning
, none
"none"
The invoice address of the invoice.
The notice of the invoice.
"This invoice is with a special discount."
The net amount of the invoice.
The total net discount amount of the invoice.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The xml representation of the invoice in EN16931 or x-Rechnung format.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The positions of the invoice.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255
"19%"
Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED
, REVERSE_CHARGE
, REVERSE_CHARGE_INTRA_EU_SUPPLY
"REVERSE_CHARGE"
standard
, reduced
"standard"
"00000000-0000-0000-0000-000000000000"
The tax of the invoice position item, calculated based on the tax group.
Some internal code
"19"
Tax rate in percent
0 <= x <= 100
19
"00000000-0000-0000-0000-000000000000"
Some internal description
255
"19%"
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The applicated exchange rates of the invoice, fetched from the european central bank.
"EUR"
"CHF"
"1.135"
The einvoice generated xml file format.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
"1234567890123"
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
{ "field1": "value1", "field2": "value2" }
The earliest service date of all positions.
The latest service date of all positions.
Public url to view the detailed usage breakdown of this invoice.
Dunning is disabled for this invoice.
Where the invoice was created from.
Possible values:
cart
: The invoice was created from a cart.subscription
: The invoice was created from a subscription billing run.manual
: The invoice was created by a user.
The type of the invoice.
TYPE_INVOICE
, TYPE_CREDIT
, TYPE_REFUND
, TYPE_REMINDER
, TYPE_CANCEL
, TYPE_DUNNING
"TYPE_INVOICE"
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
"EUR"
The document id of the invoice. This will be generated, when the invoice will be finalized.
"RE-0000000001"
STATUS_DRAFT
, STATUS_PAID
, STATUS_CANCELLED
, STATUS_CLOSED
, STATUS_REFUNDED
, STATUS_REMINDED
, STATUS_UNPAID
, STATUS_NEW
, STATUS_FINALIZING
reminder
, dunning
, none
"none"
The invoice address of the invoice.
The notice of the invoice.
"This invoice is with a special discount."
The net amount of the invoice.
The total net discount amount of the invoice.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The xml representation of the invoice in EN16931 or x-Rechnung format.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The positions of the invoice.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255
"19%"
Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED
, REVERSE_CHARGE
, REVERSE_CHARGE_INTRA_EU_SUPPLY
"REVERSE_CHARGE"
standard
, reduced
"standard"
"00000000-0000-0000-0000-000000000000"
The tax of the invoice position item, calculated based on the tax group.
Some internal code
"19"
Tax rate in percent
0 <= x <= 100
19
"00000000-0000-0000-0000-000000000000"
Some internal description
255
"19%"
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255
"19%"
Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED
, REVERSE_CHARGE
, REVERSE_CHARGE_INTRA_EU_SUPPLY
"REVERSE_CHARGE"
standard
, reduced
"standard"
"00000000-0000-0000-0000-000000000000"
The tax of the invoice position item, calculated based on the tax group.
Some internal code
"19"
Tax rate in percent
0 <= x <= 100
19
"00000000-0000-0000-0000-000000000000"
Some internal description
255
"19%"
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The applicated exchange rates of the invoice, fetched from the european central bank.
The einvoice generated xml file format.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
"1234567890123"
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
{ "field1": "value1", "field2": "value2" }
The earliest service date of all positions.
The latest service date of all positions.
Public url to view the detailed usage breakdown of this invoice.
Dunning is disabled for this invoice.
Where the invoice was created from.
Possible values:
cart
: The invoice was created from a cart.subscription
: The invoice was created from a subscription billing run.manual
: The invoice was created by a user.
"ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b"
The customer which belongs to the transaction.
payment
, refund
"payment"
The payment method which was used for this transaction.
wallet
, sepa_debit
, stripe
, fake_provider
, paypal
, bank_transfer
, go_cardless
, testing
sepa_debit
, card
, paypal
, bank_transfer
, wallet
, fake_provider
active
, action_required
, expired
, revoked
, gateway_unconfigured
"active"
checkout
, customerfront
, api
, add_link
"api"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
The card data of the payment method, if the type is "card"
The brand of the card
"Visa"
The last 4 digits of the card
"4242"
The expiration month of the card
12
The expiration year of the card
2022
The card holder name
"Max Mustermann"
The sepa mandate data of the payment method, if the type is "sepa_debit"
The iban of the sepa mandate
"DE8937*********3232"
The bic of the sepa mandate
"COBADEFFXXX"
The mandate reference of the sepa mandate
"MNDT-2021-123456"
The signing date of the sepa mandate
"2021-01-01T00:00:00+00:00"
The paypal data of the payment method, if the type is "paypal"
The payment gateway which was used for this transaction.
Possible values:
paypal
: PayPal (supports "paypal")stripe
: Stripe (supports "card")testing
: Testing (supports all)go_cardless
: GoCardless (supports "sepa_debit")bank_transfer
: Bank Transfer (supports "bank_transfer")sepa_debit
: SEPA Credit and Debit with xml file (supports "sepa_debit")wallet
: Credit Balance from Wallet (supports "wallet")
The status of the transaction.
Possible values:
new
: The transaction is new and not yet processed. A new transaction is created when a payment is initiated.authorized
: The transaction is authorized and can be captured.authorizing
: The transaction is authorizing. No actions can be performed on the transaction.waiting
: The transaction is waiting for a response from the payment provider, or a customer input. No actions can be performed on the transaction.offsite_authorization_required
: The transaction requires an offsite authorization, e.g. 3D Secure. The customer is informed about the required authorization and redirected to the payment provider.booked
: The transaction is captured and booked on the account.captured
: The transaction is captured and will be booked on the account.dispute
: The transaction is disputed.manual
: Legacy status. Do not use.canceled
: The transaction is canceled, e.g. by the customer during the payment process, or by the merchant.pending
: The transaction is pending, and will be processed soon by the payment provider.expired
: The transaction is expired, e.g. because the customer did not complete the payment process in time.processing
: The transaction is processing, e.g. because the payment provider is currently processing the payment.failed
: The transaction failed, e.g. because the payment provider could not process the payment.unknown
: The transaction status is unknown.refunded
: The transaction is fully refunded.payedout
: The transaction was a payout.partial_refunded
: The transaction is partially refunded.refund_failed
: The transaction refund failed.
The description of the transaction.
"Payment for invoice #123"
The internal reference number of the transaction.
"123456789"
The currency code of the transaction.
The original amount which was requested.
500
The amount which was refunded.
The amount which was charged to the payment method.
500
The amount of the transaction fee.
50
The date when the transaction was created.
The date when the transaction was charged.
The reason why the transaction failed.
"The payment method was not valid."
Describes if the transaction is authorized and can be captured.
true
Describes if the transaction is refundable.
true
Describes if the transaction is currently processing and cannot perform any actions.
true
Describes if the transaction is sucessful processed.
true
The invoice which belongs to the transaction. Can be null if the transaction is not related to an invoice.
The unique identifier of the invoice.
"00000000-0000-0000-0000-000000000000"
The customer of the invoice.
The payment method which should be used to fullfill the payment of the invoice.
wallet
, sepa_debit
, stripe
, fake_provider
, paypal
, bank_transfer
, go_cardless
, testing
sepa_debit
, card
, paypal
, bank_transfer
, wallet
, fake_provider
active
, action_required
, expired
, revoked
, gateway_unconfigured
"active"
checkout
, customerfront
, api
, add_link
"api"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
The card data of the payment method, if the type is "card"
The brand of the card
"Visa"
The last 4 digits of the card
"4242"
The expiration month of the card
12
The expiration year of the card
2022
The card holder name
"Max Mustermann"
The sepa mandate data of the payment method, if the type is "sepa_debit"
The iban of the sepa mandate
"DE8937*********3232"
The bic of the sepa mandate
"COBADEFFXXX"
The mandate reference of the sepa mandate
"MNDT-2021-123456"
The signing date of the sepa mandate
"2021-01-01T00:00:00+00:00"
The paypal data of the payment method, if the type is "paypal"
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The unique identifier of the invoice.
"00000000-0000-0000-0000-000000000000"
The customer of the invoice.
The payment method which should be used to fullfill the payment of the invoice.
wallet
, sepa_debit
, stripe
, fake_provider
, paypal
, bank_transfer
, go_cardless
, testing
sepa_debit
, card
, paypal
, bank_transfer
, wallet
, fake_provider
active
, action_required
, expired
, revoked
, gateway_unconfigured
"active"
checkout
, customerfront
, api
, add_link
"api"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
The card data of the payment method, if the type is "card"
The sepa mandate data of the payment method, if the type is "sepa_debit"
The paypal data of the payment method, if the type is "paypal"
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The unique identifier of the invoice.
"00000000-0000-0000-0000-000000000000"
The customer of the invoice.
The payment method which should be used to fullfill the payment of the invoice.
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The type of the invoice.
TYPE_INVOICE
, TYPE_CREDIT
, TYPE_REFUND
, TYPE_REMINDER
, TYPE_CANCEL
, TYPE_DUNNING
"TYPE_INVOICE"
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
"EUR"
The document id of the invoice. This will be generated, when the invoice will be finalized.
"RE-0000000001"
STATUS_DRAFT
, STATUS_PAID
, STATUS_CANCELLED
, STATUS_CLOSED
, STATUS_REFUNDED
, STATUS_REMINDED
, STATUS_UNPAID
, STATUS_NEW
, STATUS_FINALIZING
reminder
, dunning
, none
"none"
The invoice address of the invoice.
The notice of the invoice.
"This invoice is with a special discount."
The net amount of the invoice.
The total net discount amount of the invoice.
The xml representation of the invoice in EN16931 or x-Rechnung format.
The positions of the invoice.
The applicated exchange rates of the invoice, fetched from the european central bank.
The einvoice generated xml file format.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
"1234567890123"
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
{ "field1": "value1", "field2": "value2" }
The earliest service date of all positions.
The latest service date of all positions.
Public url to view the detailed usage breakdown of this invoice.
The referenced cancellation document.
{
"number": "R2021-0001",
"id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
}
Dunning is disabled for this invoice.
Where the invoice was created from.
Possible values:
cart
: The invoice was created from a cart.subscription
: The invoice was created from a subscription billing run.manual
: The invoice was created by a user.
The type of the invoice.
TYPE_INVOICE
, TYPE_CREDIT
, TYPE_REFUND
, TYPE_REMINDER
, TYPE_CANCEL
, TYPE_DUNNING
"TYPE_INVOICE"
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
"EUR"
The document id of the invoice. This will be generated, when the invoice will be finalized.
"RE-0000000001"
STATUS_DRAFT
, STATUS_PAID
, STATUS_CANCELLED
, STATUS_CLOSED
, STATUS_REFUNDED
, STATUS_REMINDED
, STATUS_UNPAID
, STATUS_NEW
, STATUS_FINALIZING
reminder
, dunning
, none
"none"
The invoice address of the invoice.
The notice of the invoice.
"This invoice is with a special discount."
The net amount of the invoice.
The total net discount amount of the invoice.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The xml representation of the invoice in EN16931 or x-Rechnung format.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The positions of the invoice.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The applicated exchange rates of the invoice, fetched from the european central bank.
"EUR"
"CHF"
"1.135"
The einvoice generated xml file format.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
"1234567890123"
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
{ "field1": "value1", "field2": "value2" }
The earliest service date of all positions.
The latest service date of all positions.
Public url to view the detailed usage breakdown of this invoice.
The referenced cancellation document.
Dunning is disabled for this invoice.
Where the invoice was created from.
Possible values:
cart
: The invoice was created from a cart.subscription
: The invoice was created from a subscription billing run.manual
: The invoice was created by a user.
The type of the invoice.
TYPE_INVOICE
, TYPE_CREDIT
, TYPE_REFUND
, TYPE_REMINDER
, TYPE_CANCEL
, TYPE_DUNNING
"TYPE_INVOICE"
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
"EUR"
The document id of the invoice. This will be generated, when the invoice will be finalized.
"RE-0000000001"
STATUS_DRAFT
, STATUS_PAID
, STATUS_CANCELLED
, STATUS_CLOSED
, STATUS_REFUNDED
, STATUS_REMINDED
, STATUS_UNPAID
, STATUS_NEW
, STATUS_FINALIZING
reminder
, dunning
, none
"none"
The invoice address of the invoice.
The notice of the invoice.
"This invoice is with a special discount."
The net amount of the invoice.
The total net discount amount of the invoice.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The xml representation of the invoice in EN16931 or x-Rechnung format.
Whether the media is public accessible or not
true
The mime type of the media
"image/jpeg"
The file extension of the media
"jpg"
The original file name of the media
"invoice.jpg"
The file name of the media in the storage
"01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg"
The date and time when the media was created
"2021-01-01T00:00:00+00:00"
The positions of the invoice.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255
"19%"
Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED
, REVERSE_CHARGE
, REVERSE_CHARGE_INTRA_EU_SUPPLY
"REVERSE_CHARGE"
standard
, reduced
"standard"
"00000000-0000-0000-0000-000000000000"
The tax of the invoice position item, calculated based on the tax group.
Some internal code
"19"
Tax rate in percent
0 <= x <= 100
19
"00000000-0000-0000-0000-000000000000"
Some internal description
255
"19%"
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The unit of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
10
The fixed applied discount amount of the invoice position item.
The description of the invoice position item.
"My subscription product"
The description of the invoice position item.
"* my subscription product"
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product
, discount
, setup
, dunning_fee
, invoice
"product"
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
"2020-01-01T00:00:00+00:00"
"https://example.com/"
"https://example.com/"
The service date from of the invoice position item.
"2020-01-01T00:00:00+00:00"
The service date to of the invoice position item.
"2020-01-01T00:00:00+00:00"
The applicated exchange rates of the invoice, fetched from the european central bank.
"EUR"
"CHF"
"1.135"
The einvoice generated xml file format.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
"1234567890123"
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
{ "field1": "value1", "field2": "value2" }
The earliest service date of all positions.
The latest service date of all positions.
Public url to view the detailed usage breakdown of this invoice.
Dunning is disabled for this invoice.
Where the invoice was created from.
Possible values:
cart
: The invoice was created from a cart.subscription
: The invoice was created from a subscription billing run.manual
: The invoice was created by a user.
The reference id of the payment provider.
"ch_1J3AJ2"
Was this page helpful?
curl -X GET \
/payment/bank-account-transaction-assignments/{id} \
--header "Authorization: Bearer <token>"
{
"id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
"invoice": {
"id": "00000000-0000-0000-0000-000000000000",
"customer": {},
"paymentMethod": {
"id": "<string>",
"gatewayName": "wallet",
"type": "sepa_debit",
"referenceId": "<string>",
"default": true,
"status": "active",
"source": "api",
"enabled": true,
"name": "<string>",
"data": [
"<string>"
],
"creationDate": "2023-11-07T05:31:56Z",
"expirationDate": "2023-11-07T05:31:56Z",
"sepaMandate": {},
"card": {
"brand": "Visa",
"last4": "4242",
"expMonth": 12,
"expYear": 2022,
"cardHolder": "Max Mustermann"
},
"sepaDebit": {
"iban": "DE8937*********3232",
"bic": "COBADEFFXXX",
"mandateReference": "MNDT-2021-123456",
"signingDate": "2021-01-01T00:00:00+00:00"
},
"paypal": {
"email": "max@mustermann.de",
"billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
}
},
"referencedInvoice": {},
"type": "TYPE_INVOICE",
"currencyCode": "EUR",
"number": "RE-0000000001",
"status": "STATUS_DRAFT",
"creationDate": "2023-11-07T05:31:56Z",
"finalizationDate": "2023-11-07T05:31:56Z",
"dueDate": "2023-11-07T05:31:56Z",
"lastReminderDate": "2023-11-07T05:31:56Z",
"lastSentAt": "2023-11-07T05:31:56Z",
"dunningLevel": 123,
"dunningStatus": "none",
"payDate": "2023-11-07T05:31:56Z",
"invoiceAddress": "<any>",
"internalNote": "This invoice is with a special discount.",
"title": "<string>",
"introduction": "<string>",
"closing": "<string>",
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"file": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"xmlFile": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"positions": [
{
"id": {},
"position": 123,
"quantity": 1,
"unit": {
"id": {},
"name": "Stück"
},
"unitPrice": {},
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"discountPercentage": 10,
"name": "My subscription product",
"description": "* my subscription product",
"taxGroup": {
"id": "00000000-0000-0000-0000-000000000000",
"internalDescription": "19%",
"reverseChargeType": "REVERSE_CHARGE",
"type": "standard"
},
"tax": {
"id": "00000000-0000-0000-0000-000000000000",
"description": "19%",
"code": "19",
"rate": 19
},
"type": "product",
"parent": {},
"group": {
"id": "ad8a3b9e-5b0a-4e1a-9c1a-0b9b2b8b0b0b",
"ranking": 1,
"name": "Subscription #12345"
},
"createdAt": "2020-01-01T00:00:00+00:00",
"product": "https://example.com/",
"subscriptionItem": "https://example.com/",
"serviceDateFrom": "2020-01-01T00:00:00+00:00",
"serviceDateTo": "2020-01-01T00:00:00+00:00"
}
],
"applicatedExchangeRates": [
{
"sourceCurrencyCode": "EUR",
"destinationCurrencyCode": "CHF",
"exchangeRate": "1.135",
"exchangeRateDate": "2023-11-07T05:31:56Z"
}
],
"eInvoiceType": "<any>",
"leitwegId": "1234567890123",
"customFields": {
"field1": "value1",
"field2": "value2"
},
"serviceDateFrom": "2023-11-07T05:31:56Z",
"serviceDateTo": "2023-11-07T05:31:56Z",
"unpaidAmount": {},
"usageBreakdownUrl": "<string>",
"cancellationDocument": {
"number": "R2021-0001",
"id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
},
"dunningDisabled": true,
"sourceType": "<any>"
},
"transaction": {
"id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
"customer": {},
"type": "payment",
"paymentMethod": {
"id": "<string>",
"gatewayName": "wallet",
"type": "sepa_debit",
"referenceId": "<string>",
"default": true,
"status": "active",
"source": "api",
"enabled": true,
"name": "<string>",
"data": [
"<string>"
],
"creationDate": "2023-11-07T05:31:56Z",
"expirationDate": "2023-11-07T05:31:56Z",
"sepaMandate": {},
"card": {
"brand": "Visa",
"last4": "4242",
"expMonth": 12,
"expYear": 2022,
"cardHolder": "Max Mustermann"
},
"sepaDebit": {
"iban": "DE8937*********3232",
"bic": "COBADEFFXXX",
"mandateReference": "MNDT-2021-123456",
"signingDate": "2021-01-01T00:00:00+00:00"
},
"paypal": {
"email": "max@mustermann.de",
"billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
}
},
"gateway": "<any>",
"status": "<any>",
"description": "Payment for invoice #123",
"documentNumber": "123456789",
"currencyCode": "EUR",
"amount": 500,
"refundedAmount": 123,
"chargedAmount": 500,
"feeAmount": 50,
"createdAt": "2023-11-07T05:31:56Z",
"paidAt": "2023-11-07T05:31:56Z",
"failReason": "The payment method was not valid.",
"authorized": true,
"refundable": true,
"processing": true,
"captured": true,
"invoice": {
"id": "00000000-0000-0000-0000-000000000000",
"customer": {},
"paymentMethod": {
"id": "<string>",
"gatewayName": "wallet",
"type": "sepa_debit",
"referenceId": "<string>",
"default": true,
"status": "active",
"source": "api",
"enabled": true,
"name": "<string>",
"data": [
"<string>"
],
"creationDate": "2023-11-07T05:31:56Z",
"expirationDate": "2023-11-07T05:31:56Z",
"sepaMandate": {},
"card": {
"brand": "Visa",
"last4": "4242",
"expMonth": 12,
"expYear": 2022,
"cardHolder": "Max Mustermann"
},
"sepaDebit": {
"iban": "DE8937*********3232",
"bic": "COBADEFFXXX",
"mandateReference": "MNDT-2021-123456",
"signingDate": "2021-01-01T00:00:00+00:00"
},
"paypal": {
"email": "max@mustermann.de",
"billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
}
},
"referencedInvoice": {},
"type": "TYPE_INVOICE",
"currencyCode": "EUR",
"number": "RE-0000000001",
"status": "STATUS_DRAFT",
"creationDate": "2023-11-07T05:31:56Z",
"finalizationDate": "2023-11-07T05:31:56Z",
"dueDate": "2023-11-07T05:31:56Z",
"lastReminderDate": "2023-11-07T05:31:56Z",
"lastSentAt": "2023-11-07T05:31:56Z",
"dunningLevel": 123,
"dunningStatus": "none",
"payDate": "2023-11-07T05:31:56Z",
"invoiceAddress": "<any>",
"internalNote": "This invoice is with a special discount.",
"title": "<string>",
"introduction": "<string>",
"closing": "<string>",
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"file": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"xmlFile": {
"id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
"isPrivate": true,
"mimeType": "image/jpeg",
"fileExtension": "jpg",
"fileName": "invoice.jpg",
"storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
"createdAt": "2021-01-01T00:00:00+00:00"
},
"positions": [
{
"id": {},
"position": 123,
"quantity": 1,
"unit": {
"id": {},
"name": "Stück"
},
"unitPrice": {},
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"discountPercentage": 10,
"name": "My subscription product",
"description": "* my subscription product",
"taxGroup": {
"id": "00000000-0000-0000-0000-000000000000",
"internalDescription": "19%",
"reverseChargeType": "REVERSE_CHARGE",
"type": "standard"
},
"tax": {
"id": "00000000-0000-0000-0000-000000000000",
"description": "19%",
"code": "19",
"rate": 19
},
"type": "product",
"parent": {},
"group": {
"id": "ad8a3b9e-5b0a-4e1a-9c1a-0b9b2b8b0b0b",
"ranking": 1,
"name": "Subscription #12345"
},
"createdAt": "2020-01-01T00:00:00+00:00",
"product": "https://example.com/",
"subscriptionItem": "https://example.com/",
"serviceDateFrom": "2020-01-01T00:00:00+00:00",
"serviceDateTo": "2020-01-01T00:00:00+00:00"
}
],
"applicatedExchangeRates": [
{
"sourceCurrencyCode": "EUR",
"destinationCurrencyCode": "CHF",
"exchangeRate": "1.135",
"exchangeRateDate": "2023-11-07T05:31:56Z"
}
],
"eInvoiceType": "<any>",
"leitwegId": "1234567890123",
"customFields": {
"field1": "value1",
"field2": "value2"
},
"serviceDateFrom": "2023-11-07T05:31:56Z",
"serviceDateTo": "2023-11-07T05:31:56Z",
"unpaidAmount": {},
"usageBreakdownUrl": "<string>",
"cancellationDocument": {
"number": "R2021-0001",
"id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
},
"dunningDisabled": true,
"sourceType": "<any>"
},
"referenceId": "ch_1J3AJ2"
},
"amount": {},
"fee": {},
"matchedAt": "2023-11-07T05:31:56Z"
}