---
title: "Request which is being send to customers decision making systems"
method: POST
path: "/auth"
tags: ["Forward authorisation webhook"]
---

# Request which is being send to customers decision making systems

`POST /auth`

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

## Request body

- AuthorisationRequestV1
  - `metadata` object, required — Additional metadata
    - `systemTimeStamp` string, date-time, required — 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
    - `traceId` string — Unique random-generated id per message
    - `transactionId` string — Transaction identifier generated by Enfuce
    - `linkId` string — A link ID number linking all messages connected to the same purchase
    - `cardId` string — Enfuce Card ID
    - `customerId` string — Enfuce Customer Identifier
    - `institutionId` string — Institution Identifier
    - `fees` Fee[] — 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` 'MARKUP_FEE' | 'ATM_FEE' | 'CASH_FEE' | 'UNKNOWN', required — * `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.
      - `settlementAmount` string, required — Fee Settlement Amount
      - `settlementCurrency` string, required — Fee Settlement Currency
    - `available` Money — Amount including currency
      - `amount` number
      - `currency` string — A valid ISO 4217 currency code
    - `authLengthInMinutes` string — 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
    - `retry` boolean — If set to true, indicates that message is redelivered
    - `partialApprovalCapableMerchant` boolean — 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.
    - `incremental` boolean — If set to true, this is an incremental transaction
  - `authorisation` object, required — ISO8583 authorisation message
    - `MTI` string, required — Message Type Identifier
    - `DE03` string, required — Processing code
    - `DE04` string, required — Amount, Transaction
    - `DE05` string — Amount, Settlement
    - `DE06` string — Amount, Cardholder Billing
    - `DE07` string, required — Transmission Date and Time
    - `DE10` string — Conversion Rate, Cardholder Billing
    - `DE11` string, required — System Trace Audit Number
    - `DE12` string, required — Time, Local Transaction
    - `DE13` string, required — Date, Local Transaction
    - `DE14` string — Date, Expiration
    - `DE15` string — Date, Settlement
    - `DE18` string, required — Merchant Type
    - `DE19` string — Acquiring Institution Country Code
    - `DE20` string — PAN Country Code
    - `DE22` string, required — Point of Service Entry Mode
    - `DE23` string — Card Sequence Number
    - `DE25` string — Point of Service Condition Code
    - `DE26` string — Point of Service PIN capture Code
    - `DE28` string — Amount, Transaction Fee
    - `DE32` string, required — Acquiring institution Identification Code
    - `DE33` string — Forwarding institution Identification Code
    - `DE37` string, required — Retrieval Referenece Number
    - `DE38` string — Authorisation Identification Response
    - `DE39` string — Response Code
    - `DE41` string — Card Acceptor Terminal Identification
    - `DE42` string — Card Acceptor Identification Code
    - `DE43` string — Card Acceptor Name/Location
    - `DE46` string — Proprietary field 46
    - `DE47` string — Proprietary field 47
    - `DE48` string — Proprietary field 48
    - `DE49` string, required — Currency Code, transaction
    - `DE50` string — Currency Code, settlement
    - `DE51` string — Currency Code , Cardholder Billing
    - `DE90` string — Original Data Elements
    - `DE95` string — Replacement amounts

## Response `200`

- AuthorisationResponseV1
  - `authorisationResponse` object, required — ISO8583 authorisation message
    - `DE39` string, required — Response Code
    - `DE05` string — Amount in settlement currency. Should be present for partial approval debit case
    - `DE04` string — Deprecated. Amount, Transaction. Should be present for partial approval debit case
    - `DE06` string — Deprecated. Amount, Cardholder Billing. Should be present for partial approval debit case for multicurrency transaction
    - `DE54` string — Deprecated. Additional Amounts. Should be present for partial approval debit case

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/revisions/dc4a41118f80/schema)