Deutsche Bank Callback API

openapi: 3.2.0
info:
  title: Callback API
  version: v2
  description: The merchant's system has to implement this endpoint to receive callback requests.
servers:
- url: https://example.com/
tags:
- name: Callback
  description: The merchant's system has to implement this endpoint to receive callback requests.
paths:
  /callback:
    post:
      tags:
      - Callback
      operationId: notifyShopPost
      parameters:
      - name: X-RequestDate
        in: header
        description: Current timestamp formatted according to RFC 7231, section 7.1.1.2; part of the signature input.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: Fri, 10 Jan 2021 14:41:15 GMT
      - name: X-RandomValue
        in: header
        description: A random value; part of the signature input.
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: X1c1IInswtMPNSTfmtGx
      - name: Digest
        in: header
        description: SHA-256 hash of the message body
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: SHA-256=/oTBp9ySS9jdnJjaX49msjmzWSsl868V7pWPrcp3mO4=
      - name: Signature
        in: header
        description: "HMAC-256 signature. The values of the \"Digest\", \"X-RequestDate\" and \"X-RandomValue\" headers \n are concatenated. The signature is calculated using the `client_key` as the secret."
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: LeeTB596cJBmDozTElmCsvc69HzDpzrnllJAqcL2sac=
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CallbackRequest'
            example:
              client_id: secret
              transaction_info:
                type: bankaccount
                transaction_bankaccount_info:
                  bankAccount:
                    bic: TESTDEL0BK2
                    iban: DE39123456790009290701
                    account_holder: Jörg Müller-Beßler
              rc: '0'
              message: Transaction successful.
              amount_total:
                amount: 100
                currency: EUR
              event_id: id1622635202153
              kind: DIRECTDEBIT
              tx_action: preauthorization
              tx_id: pmrM4SYsoJo5jQgtnlDzwm
              basket_id: bid1622635202153
              additional_data: ADDI_1234XY
      responses:
        '200':
          description: Acknowledges the receipt of the callback.
          content:
            application/json: {}
        '400':
          description: Signals an error.
          content:
            application/json: {}
      summary: Notify shop post
      x-summary-source: derived
components:
  schemas:
    PSD2Account:
      type: object
      properties:
        iban:
          maxLength: 34
          minLength: 15
          pattern: '[A-Z]{2}[0-9]{2}[A-Z0-9*]{11,30}'
          type: string
          description: The international bank account number of a bank account.
          example: DE17215730140403340300
        bban:
          type: string
          description: Used for payment accounts which have no IBAN.
        pan:
          maxLength: 35
          minLength: 0
          type: string
          description: 'Primary Account Number (PAN) of a card, can be tokenized by the ASPSP due to PCI DSS

            requirements.'
        masked_pan:
          maxLength: 35
          minLength: 0
          type: string
          description: Primary Account Number (PAN) of a card in a masked form.
        msisdn:
          maxLength: 35
          minLength: 0
          type: string
          description: An alias to access a payment account via a registered mobile phone number.
        currency:
          pattern: '[A-Z]{3}'
          type: string
          description: ISO 4217 currency code, three uppercase letters.
          example: EUR
    AliasInfo:
      type: object
      properties:
        alias:
          type: string
          description: Name of the alias.
          example: da2c9029-b180-42a7-b473-50d182a01f8a
        credit_card:
          $ref: '#/components/schemas/CreditCardInfo'
        bank_account:
          $ref: '#/components/schemas/BankAccount'
        address:
          $ref: '#/components/schemas/CommonAddress'
      description: Contains information about the created or updated alias. This field is null if the there was no 'alias_info' in the request.
    ExpiryDate:
      required:
      - month
      - year
      type: object
      properties:
        year:
          maximum: 2099
          minimum: 2000
          type: integer
          description: The credit card expiry year.
          format: int32
          example: 2021
        month:
          maximum: 12
          minimum: 1
          type: integer
          description: The credit card expiry month.
          format: int32
          example: 11
      description: The credit card expiry date.
    CommonAddressExtensions:
      type: object
      properties:
        alternative_address_data:
          $ref: '#/components/schemas/AlternativeAddressData'
        paydirekt_data:
          $ref: '#/components/schemas/AddressPaydirektData'
      description: Service specific address fields.
    PSD2CurrencyExchange:
      type: object
      properties:
        source_currency:
          type: string
          description: Currency from which an amount is to be converted in a currency conversion.
          example: USD
        exchange_rate:
          type: string
          description: 'Factor used to convert an amount from one currency into another. This reflects the

            price at which one currency was bought with another currency.'
        unit_currency:
          pattern: '[A-Z]{3}'
          type: string
          description: 'Currency in which the rate of exchange is expressed in a currency exchange. In the

            example 1 EUR = xxx CUR, the unit currency is EUR.'
          example: EUR
        target_currency:
          pattern: '[A-Z]{3}'
          type: string
          description: Currency into which an amount is to be converted in a currency conversion.
          example: EUR
        quotation_date:
          type: string
          description: Date at which an exchange rate is quoted.
          format: date
        contract_identification:
          type: string
          description: Unique identification to unambiguously identify the foreign exchange contract.
    BankAccount:
      required:
      - iban
      type: object
      properties:
        bic:
          maxLength: 11
          minLength: 11
          pattern: '[A-Z]{6}[A-Z2-9][A-NP-Z0-9][A-Z0-9]{3}'
          type: string
          description: "The business identifier code (BIC) of a bank account. If the branch identifier\n                (positions 9 to 11) is not applicable, it is set to \"XXX\". "
          example: VZVDDED1XXX
        iban:
          maxLength: 34
          minLength: 15
          pattern: '[A-Z]{2}[0-9]{2}[A-Z0-9*]{11,30}'
          type: string
          description: The international bank account number of a bank account.
          example: DE17215730140403340300
        account_holder:
          maxLength: 27
          minLength: 1
          pattern: .*
          type: string
          description: The account holder of the bank account.
          example: Max Muster
        bank_name:
          type: string
          description: Name of the bank.
          example: Musterbank
      description: Information about a bank account.
    RiskmanagementInfoResponse:
      type: object
      properties:
        case_priority:
          type: string
          description: Riskcheck information regarding the case priority.
          example: '1'
        error_information:
          $ref: '#/components/schemas/RiskmanErrorInformation'
        event_id:
          maxLength: 50
          minLength: 1
          pattern: '[\/0-9a-zA-Z_.:,\-+*$%]+'
          type: string
          description: A unique ID for the event.
          example: E5686585867636541231230
        infocodes_address:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the address risk check. See user guide for details and all possible values.
            example: '["COR-BA","COR-SA","MM-A","MM-Z"]'
        infocodes_customerlist:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the customer list risk check.  See user guide for details and all possible values.
            example: '["CONPOSNEG","NEG-BCO"]'
        infocodes_device_behaviour:
          type: array
          items:
            type: string
            description: Indicates the device behavior information code(s) returned from device fingerprinting. See user guide for details and all possible values.
            example: '["MouseOffPageDetected"]'
        infocodes_globalvelocity:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the velocity risk check. See user guide for details and all possible values.
            example: '["VEL-ADDR","VELS-FP"]'
        infocodes_identitychange:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the identity change. See user guide for details and all possible values.
            example: '["ID-M-HPOS"]'
        infocodes_internet:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the internet check. See user guide for details and all possible values.
            example: '["FREE-EM"]'
        infocodes_phone:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the phone risk check. See user guide for details and all possible values.
            example: '["MMACBST, "UNV-PH" ]'
        infocodes_suspicious:
          type: array
          items:
            type: string
            description: Riskcheck information regarding suspicious risk. See user guide for details and all possible values.
            example: '["BAD-FP","MUL-EM"]'
        infocodes_velocity:
          type: array
          items:
            type: string
            description: 'List of information codes triggered by the order. These information codes were generated when you created

              the order and product velocity rules and are returned so that you can associate them with the rules. See user guide for details and all possible values.'
            example: '["GVEL-R20","GVEL-R21"]'
        localtime:
          type: string
          description: Riskcheck information regarding the local time of the risk check.
          example: '55083'
        profile_destination_queue:
          type: string
          description: Riskcheck information regarding the profile destination queue of the risk check.
          example: dst-queue
        profile_name:
          type: string
          description: Riskcheck information regarding the profile of the risk check.
          example: example-profile
        profile_selectorrule:
          type: string
          description: Riskcheck information regarding the profile selector rule risk check.
          example: example-rule
        providers:
          type: array
          items:
            type: string
            description: Providers used to calculate the risk.
            example: '["provider1","provider2"]'
        rules:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the matched rules in risk check.
            example: '["example-rule"]'
        score:
          type: string
          description: Calculated risk score of request data.
          example: '14'
        score_factor_codes:
          type: array
          items:
            type: string
            description: Riskcheck information regarding the profile factor codes of the risk check. See user guide for all possible values.
            example: '["G","H","Y","Z"]'
        score_model_used:
          type: string
          description: Name of the score model used for the transaction. This field contains the name of risk management’s selected model.
          example: default_eu
        travel_actual_final_dst_country:
          type: string
          description: Actual country of final destination of the travel.
          example: US
        travel_actual_final_dst_locality:
          type: string
          description: Actual city of final destination of the travel.
          example: Chicago
        travel_first_departure_country:
          type: string
          description: First departure country of the travel.
          example: US
        travel_first_departure_locality:
          type: string
          description: First departure city of the travel.
          example: San Francisco
        tx_risk_status:
          type: string
          description: Status result of an external risk management transaction. See user guide for all possible values.
          example: ACCEPTED
        tx_scoring_id:
          type: string
          description: Unique scoring transaction identifier. Can be used to reference the depending scoring transaction.
          example: '6373172383866963604006'
        utc_time:
          type: string
          description: Riskcheck information regarding the UTC time of the risk check, used in error cases.
          example: '''2021-12-21T14:18:04Z'''
    CreditCardInfo:
      required:
      - expiry_date
      - number
      type: object
      properties:
        number:
          maxLength: 19
          minLength: 10
          pattern: '[0-9]*'
          type: string
          description: The credit card number (Primary Account Number). It is sometimes masked in response messages, for example 411111******1111.
          example: '41111111111111111'
        expiry_date:
          $ref: '#/components/schemas/ExpiryDate'
        cardholder:
          maxLength: 27
          minLength: 1
          type: string
          description: The holder of a credit card.
          example: Max Muster
        brand:
          type: string
          description: "The credit card brand.  The use of this field requires an explicit activation. Please contact customer support. Possible values:     \n           \n* `AMEX`\n* `DINERS`\n* `JCB`\n* `MAESTRO`\n* `MASTERCARD`\n* `VISA`        \n"
          example: VISA
          enum:
          - AMEX
          - DINERS
          - JCB
          - MAESTRO
          - MASTERCARD
          - VISA
        issuer_country:
          type: string
          description: The card issuers country of origin.  The use of this field requires an explicit activation. Please contact customer support.
      description: Information about a credit card.
    PhoneContact:
      required:
      - phone_number
      - phone_type
      type: object
      properties:
        phone_type:
          type: string
          description: 'The phone type.


            * `FAX`

            * `HOME`

            * `MOBILE`

            * `OTHER`

            * `PAGER`

            * `WORK`

            '
          example: FAX
          enum:
          - FAX
          - HOME
          - MOBILE
          - OTHER
          - PAGER
          - WORK
        phone_number:
          maxLength: 16
          minLength: 0
          pattern: \+[1-9]\d{1,14}
          type: string
          description: A phone number in its canonical international E.164 numbering plan format.
          example: '''+442071838750'''
      description: A means of contacting a customer by phone.
      example:
        phone_type: FAX
        phone_number: '''+442071838750'''
    CallbackRequest:
      required:
      - client_id
      - event_id
      - message
      - rc
      - timestamp
      - tx_id
      type: object
      properties:
        rc:
          type: string
          description: Response code of the transaction. "0" in the case of a successful transaction. Other values signify errors.
          example: '0'
        message:
          type: string
          description: Success or error message, text for the response code.
          example: Transaction approved.
        event_id:
          maxLength: 50
          minLength: 1
          pattern: '[\/0-9a-zA-Z_.:,\-+*$%]+'
          type: string
          description: A unique ID for the event.
          example: E5686585867636541231230
        tx_id:
          type: string
          description: Unique transaction identifier. Can be used to reference this transaction.
          example: 020LMG10jxSI8FN0OC4vLR
        riskmanagement_info:
          $ref: '#/components/schemas/RiskmanagementInfoResponse'
        amount_total:
          $ref: '#/components/schemas/AmountCurrency'
        kind:
          type: string
          description: The type of transaction.
          enum:
          - DIRECTDEBIT
          - CREDITCARD
          - CREDITCARD_3DS20
          - CREDITTRANSFER
          - SOFORTUEBERWEISUNG
          - PAYPAL
          - PAYDIREKT
          - WECHATPAY
          - P24
          - GIROPAY
          - KLARNA
          - PSD2
        tx_action:
          type: string
          description: The action of a transaction.
          enum:
          - authorization
          - capture
          - credit
          - preauthorization
          - refund
          - reversal
          - risk_check
          - verify-mop
          - payment
          - avs
          - avspayment
        alias_info:
          $ref: '#/components/schemas/AliasInfo'
        back_rc:
          maxLength: 255
          minLength: 0
          type: string
          description: Response code of a backend system, for example the GICC response code.
          example: '00'
        timestamp:
          type: string
          description: Timestamp of the transaction.
          format: date-time
        transaction_info:
          $ref: '#/components/schemas/TransactionInfo'
        client_id:
          type: string
          description: The client ID used to calculate the signature.
          example: 2b48b7c6-8a3b-4f96-a64d-7a08d0c74627
        basket_id:
          type: string
          description: The shopping basket number as submitted in the initial request.
          example: basket123456
        additional_data:
          type: string
          description: As submitted in the initial request.
          example: SESSION_1234X
        accounts:
          type: array
          description: Account details after a PSD2 account info request.
          items:
            $ref: '#/components/schemas/PSD2AccountDetails'
    CommonAddress:
      type: object
      properties:
        title:
          type: string
          description: Customer's title.
          example: Ms
        first_name:
          maxLength: 60
          minLength: 0
          type: string
          description: First name of the individual.
          example: Jane
        last_name:
          maxLength: 60
          minLength: 0
          type: string
          description: Last name of the individual.
          example: Doe
        company_name:
          maxLength: 60
          minLength: 0
          type: string
          description: Name of the company.
          example: Acme Inc.
        email:
          maxLength: 255
          minLength: 0
          type: string
          description: Email address of the individual.
          example: test_jane@gmail.com
        phone_contact:
          $ref: '#/components/schemas/PhoneContact'
        address_line_1:
          maxLength: 60
          minLength: 0
          type: string
          description: An address line.
          example: Main Street 123
        address_line_2:
          maxLength: 60
          minLength: 0
          type: string
          description: An address line. For 3DS this maps to additional1.
          example: Building A
        address_line_3:
          maxLength: 60
          minLength: 0
          type: string
          description: An address line. For 3DS this maps to additional2.
          example: Apartment 12
        street:
          type: string
          description: The street.
          example: Main Street
        street_number:
          type: string
          description: The street number.
          example: 123a
        postal_code:
          maxLength: 60
          minLength: 0
          type: string
          description: Postal code of the address.
          example: '80469'
        city:
          maxLength: 60
          minLength: 0
          type: string
          description: City of the address.
          example: Munich
        state:
          maxLength: 300
          minLength: 0
          type: string
          description: State or province of the address.
          example: BY
        country:
          maxLength: 2
          minLength: 2
          pattern: '[A-Z]{2}'
          type: string
          description: The ISO 3166 Alpha-2 country code (upper case) of the individual's homeland.
          example: DE
        extensions:
          $ref: '#/components/schemas/CommonAddressExtensions'
      description: Address data as applicable to most use cases.
    RiskmanErrorFieldInformation:
      type: object
      properties:
        field:
          type: string
          description: The name of the field which was the reason of the request rejection.
          example: orderInformation.billTo.firstName
        reason:
          type: string
          description: The reason why the request was rejected.
          example: MISSING_FIELD
      description: Field name and reason why the request was rejected.
    TDSInfo:
      type: object
      properties:
        tds_auth_level:
          type: string
          description: "The 3D-Secure transaction status.\n        \n* `FULL`: Full 3-D Secure Authentification\n* `ATTEMPT`: 3-D Secure Authentification attempted\n"
          example: ATTEMPT
          enum:
          - FULL
          - ATTEMPT
        tds_version:
          maxLength: 10
          minLength: 0
          type: string
          description: 3-D Secure version.
        tds_ares_cardholder_info:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: ARes card holder information.'
        tds_ares_error_code:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: ARes error code.'
        tds_ares_error_component:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: ARes error component.'
        tds_ares_trans_status:
          maxLength: 1
          minLength: 0
          type: string
          description: '3-D Secure 2: ARes transaction status.'
          example: Y
        tds_ares_trans_status_reason:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: reason for the ARes transaction status.'
          example: MediumConfidence
        tds_rreq_challenge_cancel_indicator:
          maxLength: 80
          minLength: 0
          type: string
          description: Optional 3-D Secure 2 response parameter.
          example: CardholderCancel
        tds_rreq_error_code:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: RReq error code.'
        tds_rreq_error_component:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: RReq error component.'
        tds_rreq_trans_status:
          maxLength: 1
          minLength: 0
          type: string
          description: '3-D Secure 2: RReq transaction status.'
        tds_rreq_trans_status_reason:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: reason for the RReq transaction status.'
          example: MediumConfidence
        tds_ares_error_description:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: ARes error description.'
        tds_ares_error_detail:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: ARes error detail.'
        tds_rreq_error_description:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: RReq error description.'
        tds_rreq_error_detail:
          maxLength: 80
          minLength: 0
          type: string
          description: '3-D Secure 2: RReq error detail.'
      description: Contains 3-D Secure response data.  The use of this field requires an explicit activation. Please contact customer support.
    TransactionCreditCardInfo:
      type: object
      properties:
        credit_card:
          $ref: '#/components/schemas/CreditCardInfo'
        tds_info:
          $ref: '#/components/schemas/TDSInfo'
        recurring_payment:
          maxLength: 50
          minLength: 1
          pattern: '[/0-9a-zA-Z_.:,+*$%-]+'
          type: string
          description: Identifier of a recurring credit card payment.
          example: 07H987Tx3PF9VxL5G7RfNp
        cvc_result:
          type: string
          description: "Response code of the verification of the card verification code\n         according to the response of a backend system.  This value is available on some backend systems.  The use of this field requires an explicit activation. Please contact customer support.  \n         Possible values:\n        \n* `CVC_MATCH`\n* `CVC_NO_MATCH`\n* `CVC_NO_RESPONSE_RECEIVED`\n* `CVC_NOT_PROCESSED`\n* `CVC_NOT_PROVIDED`\n* `CVC_SHOULD_BE_ON_CARD`\n* `CVC_VERIFICATION_UNAVAILABLE`\n\n"
          example: CVC_MATCH
          enum:
          - CVC_MATCH
          - CVC_NO_MATCH
          - CVC_NO_RESPONSE_RECEIVED
          - CVC_NOT_PROCESSED
          - CVC_NOT_PROVIDED
          - CVC_SHOULD_BE_ON_CARD
          - CVC_VERIFICATION_UNAVAILABLE
        avs_result:
          type: string
          description: "Response code of the address verification according to the response of a backend system. \n         This value is available on some backend systems.  The use of this field requires an explicit activation. Please contact customer support.  Possible values:\n        \n* `MATCH`\n* `NO_MATCH`\n"
          example: MATCH
          enum:
          - MATCH
          - NO_MATCH
    MandateResponse:
      required:
      - signed_on
      type: object
      properties:
        mandate_id:
          maxLength: 32
          minLength: 32
          type: string
          description: Unique identification of the SEPA mandate. Use it for managed and already created mandates.
          example: 89c3d6b532be80339839f1605201f2c7
        signed_on:
          type: string
          description: Date when the SEPA mandate was issued. Full-date notation as defined by RFC 3339, section 5.6.
          format: date
          example: '2017-01-01'
    PSD2AccountDetails:
      type: object
      properties:
        iban:
          type: string
          description: The international bank account number of a bank account.
          example: DE17215730140403340300
        currency:
          pattern: '[A-Z]{3}'
          type: string
          description: ISO 4217 currency code, three uppercase letters.
          example: EUR
        name:
          maxLength: 35
          minLength: 0
          type: string
          description: Name of the account given by the bank or the PSU in online-banking.
        owner_name:
          maxLength: 140
          minLength: 0
          type: string
          description: Name(s) of the account owner(s).
        product:
          maxLength: 35
          minLength: 0
          type: string
          description: Product name of the bank for this account, proprietary definition.
        status:
          type: string
          description: 'Status of the account


            * `ENABLED`: account is available

            * `DELETED`: account is terminated

            * `BLOCKED`: account is blocked for example for legal reasons'
          enum:
          - ENABLED
          - DELETED
          - BLOCKED
        usage:
          type: string
          description: 'Specifies the usage of the account


            * `PRIV`: private personal account

            * `ORGA`: professional account

            * `TEST_USAGE`: returned by Sparkassen sandbox'
          enum:
          - PRIV
          - ORGA
          - TEST_USAGE
        details:
          maxLength: 500
          minLength: 0
          type: string
          description: 'Specifications that might be provided by the ASPSP such as characteristics of the account or

            characteristics of the relevant card.'
        balances:
          type: array
          description: Balance(s) of the account. There might be more than one balance with different types.
          items:
            $ref: '#/components/schemas/PSD2Balance'
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/PSD2Transaction'
      description: Contains details of a customer's bank account.
    PSD2Remittance:
      type: object
      properties:
        reference:
          maxLength: 35
          minLength: 0
          type: string
        reference_type:
          maxLength: 35
          minLength: 0
          type: string
        reference_issuer:
          maxLength: 35
          minLength: 0
          type: string
    TransactionInfo:
      type: object
      properties:
        type:
          type: string
          enum:
          - creditcard
          - bankaccount
        transaction_creditcard_info:
          $ref: '#/components/schemas/TransactionCreditCardInfo'
        transaction_bankaccount_info:
          $ref: '#/components/schemas/TransactionBankAccountInfo'
        mandate_data:
          $ref: '#/components/schemas/MandateResponse'
        back_state:
          type: string
          description: "State of a transaction according to the response of a backend system. \n         This value is available on some backend systems.  The use of this field requires an explicit activation. Please contact customer support.  Possible values:\n        \n* `DECLINED`\n* `AUTHORIZED`\n* `REVERSED`\n* `CAPTURED`\n* `SETTLED`\n"
          example: REVERSED
          enum:
          - DECLINED
          - AUTHORIZED
          - REVERSED
          - CAPTURED
          - SETTLED
        ip_address:
          type: string
          description: The customer's IP address associated with this transaction.  The use of this field requires an explicit activation. Please contact customer support.
    AmountCurrency:
      required:
      - amount
      - currency
      type: object
      properties:
        amount:
          type: integer
          description: Minor currency value of an amount of money.
          format: int64
          example: 200
        currency:
          maxLength: 3
          minLength: 3
          pattern: '[A-Z]{3}'
          type: string
          description: ISO 4217 currency code, three uppercase letters.
          example: EUR
      description: An amount and a currency.
    PSD2Balance:
      required:
      - amount
      - type
      type: object
      properties:
        amount:
          $ref: '#/components/schemas/AmountCurrency'
        type:
          type: string
          description: 'The following balance types are excluding credit limits unless the `credit_limit_included` element

            is present and equals true in the corresponding balance element.

            This definition is following ISO20022 logic for defining balance types.


            * `CLOSING_BOOKED`: Balance of the account at the end of the pre-agreed account reporting

            period. It is the sum of the opening booked balance at the beginning of

            the period and all entries booked to the account during the pre-agreed

            account reporting period. For card-accounts, this is composed of invoiced, but not yet paid entries

            * `EXPECTED`: Balance composed of booked entries and pending items known at the

            time of calculation, which projects the end of day balance if everything

            is booked on

# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/deutsche-bank/refs/heads/main/openapi/deutsche-bank-callback-api-openapi.yml