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
curl --request POST \
--url http://localhost/auth \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"metadata": {
"systemTimeStamp": "2021-10-14T09:23:54.611951Z",
"traceId": "<string>",
"transactionId": "<string>",
"linkId": "<string>",
"cardId": "<string>",
"customerId": "<string>",
"institutionId": "<string>",
"fees": [
{
"type": "MARKUP_FEE",
"settlementAmount": "<string>",
"settlementCurrency": "<string>"
}
],
"available": {
"amount": 3.14,
"currency": "EUR"
},
"authLengthInMinutes": "<string>",
"retry": true,
"partialApprovalCapableMerchant": true,
"incremental": true,
"shadowBalancingEnabled": true
},
"authorisation": {
"MTI": "<string>",
"DE03": "<string>",
"DE04": "<string>",
"DE07": "<string>",
"DE11": "<string>",
"DE12": "<string>",
"DE13": "<string>",
"DE18": "<string>",
"DE22": "<string>",
"DE32": "<string>",
"DE37": "<string>",
"DE49": "<string>",
"DE05": "<string>",
"DE06": "<string>",
"DE10": "<string>",
"DE14": "<string>",
"DE15": "<string>",
"DE19": "<string>",
"DE20": "<string>",
"DE23": "<string>",
"DE25": "<string>",
"DE26": "<string>",
"DE28": "<string>",
"DE33": "<string>",
"DE38": "<string>",
"DE39": "<string>",
"DE41": "<string>",
"DE42": "<string>",
"DE43": "<string>",
"DE46": "<string>",
"DE47": "<string>",
"DE48": "<string>",
"DE50": "<string>",
"DE51": "<string>",
"DE90": "<string>",
"DE95": "<string>"
}
}
'{
"authorisationResponse": {
"DE39": "<string>",
"DE05": "<string>",
"DE04": "<string>",
"DE06": "<string>",
"DE54": "<string>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Additional metadata
Show child attributes
Show child attributes
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
"2021-10-14T09:23:54.611951Z"
Unique random-generated id per message
Transaction identifier generated by Enfuce
A link ID number linking all messages connected to the same purchase
Enfuce Card ID
Enfuce Customer Identifier
Institution Identifier
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
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.
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
If set to true, indicates that message is redelivered
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.
If set to true, this is an incremental transaction
If set to true, indicates that shadow balancing is enabled for the account. If not set or null, shadow balancing is disabled.
ISO8583 authorisation message
Show child attributes
Show child attributes
Message Type Identifier
Processing code
Amount, Transaction
Transmission Date and Time
System Trace Audit Number
Time, Local Transaction
Date, Local Transaction
Merchant Type
Point of Service Entry Mode
Acquiring institution Identification Code
Retrieval Referenece Number
Currency Code, transaction
Amount, Settlement
Amount, Cardholder Billing
Conversion Rate, Cardholder Billing
Date, Expiration
Date, Settlement
Acquiring Institution Country Code
PAN Country Code
Card Sequence Number
Point of Service Condition Code
Point of Service PIN capture Code
Amount, Transaction Fee
Forwarding institution Identification Code
Authorisation Identification Response
Response Code
Card Acceptor Terminal Identification
Card Acceptor Identification Code
Card Acceptor Name/Location
Proprietary field 46
Proprietary field 47
Proprietary field 48
Currency Code, settlement
Currency Code , Cardholder Billing
Original Data Elements
Replacement amounts
Response
ISO8583 authorisation message
Show child attributes
Show child attributes
Response Code
Amount in settlement currency. Should be present for partial approval debit case
Deprecated. Amount, Transaction. Should be present for partial approval debit case
Deprecated. Amount, Cardholder Billing. Should be present for partial approval debit case for multicurrency transaction
Deprecated. Additional Amounts. Should be present for partial approval debit case
Was this page helpful?
curl --request POST \
--url http://localhost/auth \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"metadata": {
"systemTimeStamp": "2021-10-14T09:23:54.611951Z",
"traceId": "<string>",
"transactionId": "<string>",
"linkId": "<string>",
"cardId": "<string>",
"customerId": "<string>",
"institutionId": "<string>",
"fees": [
{
"type": "MARKUP_FEE",
"settlementAmount": "<string>",
"settlementCurrency": "<string>"
}
],
"available": {
"amount": 3.14,
"currency": "EUR"
},
"authLengthInMinutes": "<string>",
"retry": true,
"partialApprovalCapableMerchant": true,
"incremental": true,
"shadowBalancingEnabled": true
},
"authorisation": {
"MTI": "<string>",
"DE03": "<string>",
"DE04": "<string>",
"DE07": "<string>",
"DE11": "<string>",
"DE12": "<string>",
"DE13": "<string>",
"DE18": "<string>",
"DE22": "<string>",
"DE32": "<string>",
"DE37": "<string>",
"DE49": "<string>",
"DE05": "<string>",
"DE06": "<string>",
"DE10": "<string>",
"DE14": "<string>",
"DE15": "<string>",
"DE19": "<string>",
"DE20": "<string>",
"DE23": "<string>",
"DE25": "<string>",
"DE26": "<string>",
"DE28": "<string>",
"DE33": "<string>",
"DE38": "<string>",
"DE39": "<string>",
"DE41": "<string>",
"DE42": "<string>",
"DE43": "<string>",
"DE46": "<string>",
"DE47": "<string>",
"DE48": "<string>",
"DE50": "<string>",
"DE51": "<string>",
"DE90": "<string>",
"DE95": "<string>"
}
}
'{
"authorisationResponse": {
"DE39": "<string>",
"DE05": "<string>",
"DE04": "<string>",
"DE06": "<string>",
"DE54": "<string>"
}
}