Payment API
Account Details
- Overview
- Create an account
- Update an account
- Get account information
Authorisation Control
- Overview
- Authorisation Control Webhook
Authorisation Forwarding
- Overview
- Forward authorisation webhook
Card details
- Overview
- Create card
- Update card
- Get application
- Update application
- Get card
- Get plastic
- Get EMV scripts
- Update plastic
Customer
- Overview
- Get customer information
- Create a customer
- Update a customer
- Customer hierarchy
Exchange Rates API
- Overview
- Get ECB exchange rate
- Get ECB supported currencies
- Get FX exchange rates
ID
- Overview
- Initiate 3rd party authentication flow
- Callback to complete authentication flow
Instalment
- Overview
- Instalment Controller
Invoice
- Overview
- Get invoice information
- Update an invoice
Notification
- Overview
- Receive a notification
PIN
- Overview
- PIN operations with pre-shared key
- PIN operations using PKI
PIN Control
- Overview
- PIN Control handling
Purchase Details
- Overview
- Trigger repricing
- Get purchase details
- Create purchase details
- Update purchase details
Repricing
- Overview
- Create repricing agreements
- Get repricing agreements
- Update repricing agreements
- Create price lists
- Get price lists
- Update price lists
Transaction
- Overview
- Test transactions
- Test authorizations
- Get transaction data
- Create transactions
- Create fees
- Update a transaction
- Batch payment
Transfer API
- Overview
- Post account to account transfer
- Account to account batch transfer
- Post card to card transfer
Wallet
- Overview
- Push Provision
- Activation data
- Get tokens
Test API
- Overview
- test-auth-request-templates
- test-authorizations
Hierarchy API
- Overview
- Card Hierarchy Management
- Card Hierarchy Group Management
- Card Management in Card Hierarchy Groups
Spend Control API
- Overview
- Rule Sets Endpoints
- Rules Endpoints
- Spend Control Test Endpoint
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 '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>",
"DE05": "<string>",
"DE06": "<string>",
"DE07": "<string>",
"DE10": "<string>",
"DE11": "<string>",
"DE12": "<string>",
"DE13": "<string>",
"DE14": "<string>",
"DE15": "<string>",
"DE18": "<string>",
"DE19": "<string>",
"DE20": "<string>",
"DE22": "<string>",
"DE23": "<string>",
"DE25": "<string>",
"DE26": "<string>",
"DE28": "<string>",
"DE32": "<string>",
"DE33": "<string>",
"DE37": "<string>",
"DE38": "<string>",
"DE39": "<string>",
"DE41": "<string>",
"DE42": "<string>",
"DE43": "<string>",
"DE46": "<string>",
"DE47": "<string>",
"DE48": "<string>",
"DE49": "<string>",
"DE50": "<string>",
"DE51": "<string>",
"DE90": "<string>",
"DE95": "<string>"
}
}'{
"authorisationResponse": {
"DE39": "<string>",
"DE05": "<string>",
"DE04": "<string>",
"DE06": "<string>",
"DE54": "<string>"
}
}Body
Additional metadata
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
Fee information
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
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
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
curl --request POST \
--url http://localhost/auth \
--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>",
"DE05": "<string>",
"DE06": "<string>",
"DE07": "<string>",
"DE10": "<string>",
"DE11": "<string>",
"DE12": "<string>",
"DE13": "<string>",
"DE14": "<string>",
"DE15": "<string>",
"DE18": "<string>",
"DE19": "<string>",
"DE20": "<string>",
"DE22": "<string>",
"DE23": "<string>",
"DE25": "<string>",
"DE26": "<string>",
"DE28": "<string>",
"DE32": "<string>",
"DE33": "<string>",
"DE37": "<string>",
"DE38": "<string>",
"DE39": "<string>",
"DE41": "<string>",
"DE42": "<string>",
"DE43": "<string>",
"DE46": "<string>",
"DE47": "<string>",
"DE48": "<string>",
"DE49": "<string>",
"DE50": "<string>",
"DE51": "<string>",
"DE90": "<string>",
"DE95": "<string>"
}
}'{
"authorisationResponse": {
"DE39": "<string>",
"DE05": "<string>",
"DE04": "<string>",
"DE06": "<string>",
"DE54": "<string>"
}
}