> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enfuce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Request which is being send to customers decision making systems

> This is not an endpoint. This is the description of request the which is being sent to customers decision making system if provided



## OpenAPI

````yaml authorisation-forwarding post /auth
openapi: 3.0.3
info:
  title: Enfuce Authorisation Forwarding Schema
  description: ''
  version: 1.0.0
servers:
  - url: http://localhost
security: []
tags:
  - name: Forward authorisation webhook
paths:
  /auth:
    post:
      tags:
        - Forward authorisation webhook
      summary: Request which is being send to customers decision making systems
      description: >-
        This is not an endpoint. This is the description of request the which is
        being sent to customers decision making system if provided
      operationId: authPost
      requestBody:
        $ref: '#/components/requestBodies/authorisationRequestBodyV1'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authorisationResponseV1'
components:
  requestBodies:
    authorisationRequestBodyV1:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/authorisationRequestV1'
  schemas:
    authorisationResponseV1:
      description: ''
      type: object
      required:
        - authorisationResponse
      properties:
        authorisationResponse:
          description: ISO8583 authorisation message
          type: object
          required:
            - DE39
          properties:
            DE39:
              description: Response Code
              type: string
            DE05:
              description: >-
                Amount in settlement currency. Should be present for partial
                approval debit case
              type: string
            DE04:
              description: >-
                Deprecated. Amount, Transaction. Should be present for partial
                approval debit case
              type: string
              deprecated: true
            DE06:
              description: >-
                Deprecated. Amount, Cardholder Billing. Should be present for
                partial approval debit case for multicurrency transaction
              type: string
              deprecated: true
            DE54:
              description: >-
                Deprecated. Additional Amounts. Should be present for partial
                approval debit case
              type: string
              deprecated: true
    authorisationRequestV1:
      type: object
      required:
        - metadata
        - authorisation
      properties:
        metadata:
          description: Additional metadata
          type: object
          required:
            - systemTimeStamp
          properties:
            systemTimeStamp:
              description: >-
                UTC Enfuce authorisation forwarding system time stamp in format
                YYYY-MM-DDThh:mm:ss.SZ, where capital S represents a fraction оf
                second that can be from 0 to 9 digits long
              type: string
              format: date-time
              example: '2021-10-14T09:23:54.611951Z'
            traceId:
              description: Unique random-generated id per message
              type: string
            transactionId:
              description: Transaction identifier generated by Enfuce
              type: string
            linkId:
              description: >-
                A link ID number linking all messages connected to the same
                purchase
              type: string
            cardId:
              description: Enfuce Card ID
              type: string
            customerId:
              description: Enfuce Customer Identifier
              type: string
            institutionId:
              description: Institution Identifier
              type: string
            fees:
              description: >-
                Transaction based fees that are charged based on the
                transaction. Example: Mark-up fees for transactions done in
                non-domestic currency or ATM fees charged for ATM withdrawals.
                Fees are available in both request and advice messages
              type: array
              items:
                $ref: '#/components/schemas/fee'
            available:
              $ref: '#/components/schemas/money'
              description: >
                Available amount of the account that is linked to the card that
                is used.

                This amount does not consider possible spend controls.

                Note that this amount is only valid for setups where ledger is
                managed by Enfuce.

                If ledger is held by issuer, the amount in this field will be
                zero (0).


                The available amount is fetched mid-authorisation process.

                As the end to end authorisation process takes 0,5-3 sec, there
                can occur situations where another authorisation, API
                transaction or financial transaction is processed in parallel
                which is not reflected in the available.

                This is however extremely rare.


                The amount provided in this field can have a minus sign if the
                account is overlimit.
            authLengthInMinutes:
              description: >-
                Authorisation life cycle length in minutes. Only available if
                merchant has requested a prolonged authorisation expiry time. If
                empty, Enfuce standard authorisation expiration time applies
              type: string
            retry:
              description: If set to true, indicates that message is redelivered
              type: boolean
            partialApprovalCapableMerchant:
              description: >
                Indicates if merchant will accept partial approval of amount.

                E.g. at a fuel pump the initial authorisation might be a
                predefined flat amount to which the issuer can respond an
                available amount smaller than the actual authorisation request.


                Note that this functionality is only available when card account
                balance resides at issuer.
              type: boolean
            incremental:
              description: If set to true, this is an incremental transaction
              type: boolean
        authorisation:
          description: ISO8583 authorisation message
          type: object
          required:
            - MTI
            - DE03
            - DE04
            - DE07
            - DE11
            - DE12
            - DE13
            - DE18
            - DE22
            - DE32
            - DE37
            - DE49
          properties:
            MTI:
              description: Message Type Identifier
              type: string
            DE03:
              description: Processing code
              type: string
            DE04:
              description: Amount, Transaction
              type: string
            DE05:
              description: Amount, Settlement
              type: string
            DE06:
              description: Amount, Cardholder Billing
              type: string
            DE07:
              description: Transmission Date and Time
              type: string
            DE10:
              description: Conversion Rate, Cardholder Billing
              type: string
            DE11:
              description: System Trace Audit Number
              type: string
            DE12:
              description: Time, Local Transaction
              type: string
            DE13:
              description: Date, Local Transaction
              type: string
            DE14:
              description: Date, Expiration
              type: string
            DE15:
              description: Date, Settlement
              type: string
            DE18:
              description: Merchant Type
              type: string
            DE19:
              description: Acquiring Institution Country Code
              type: string
            DE20:
              description: PAN Country Code
              type: string
            DE22:
              description: Point of Service Entry Mode
              type: string
            DE23:
              description: Card Sequence Number
              type: string
            DE25:
              description: Point of Service Condition Code
              type: string
            DE26:
              description: Point of Service PIN capture Code
              type: string
            DE28:
              description: Amount, Transaction Fee
              type: string
            DE32:
              description: Acquiring institution Identification Code
              type: string
            DE33:
              description: Forwarding institution Identification Code
              type: string
            DE37:
              description: Retrieval Referenece Number
              type: string
            DE38:
              description: Authorisation Identification Response
              type: string
            DE39:
              description: Response Code
              type: string
            DE41:
              description: Card Acceptor Terminal Identification
              type: string
            DE42:
              description: Card Acceptor Identification Code
              type: string
            DE43:
              description: Card Acceptor Name/Location
              type: string
            DE46:
              description: Proprietary field 46
              type: string
            DE47:
              description: Proprietary field 47
              type: string
            DE48:
              description: Proprietary field 48
              type: string
            DE49:
              description: Currency Code, transaction
              type: string
            DE50:
              description: Currency Code, settlement
              type: string
            DE51:
              description: Currency Code , Cardholder Billing
              type: string
            DE90:
              description: Original Data Elements
              type: string
            DE95:
              description: Replacement amounts
              type: string
    fee:
      description: Fee information
      type: object
      required:
        - type
        - settlementAmount
        - settlementCurrency
      properties:
        type:
          $ref: '#/components/schemas/feeType'
          description: Fee Type
        settlementAmount:
          description: Fee Settlement Amount
          type: string
        settlementCurrency:
          description: Fee Settlement Currency
          type: string
    money:
      description: Amount including currency
      type: object
      required:
        - amount
        - currency
      properties:
        amount:
          type: number
          example: 3.14
        currency:
          $ref: '#/components/schemas/currency'
    feeType:
      description: >
        * `MARKUP_FEE` - fee for transactions done in non-domestic currency. *
        `ATM_FEE` - fee for ATM withdrawals. * `CASH_FEE` - fee for cash
        transactions. * `UNKNOWN` - is a fallback value that is not expected but
        in case present represents another transaction based fee not covered by
        the above options.
      type: string
      enum:
        - MARKUP_FEE
        - ATM_FEE
        - CASH_FEE
        - UNKNOWN
    currency:
      type: string
      description: A valid ISO 4217 currency code
      pattern: '[A-Z]{3}'
      example: EUR

````