Authorisation Request API
curl --request POST \
--url 'https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth' \
--header 'Content-Type: application/json' \
--data '
{
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequenceNumber": 1,
"accountId": "<string>",
"cardholderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"groups": [
{
"groupId": "<string>"
}
]
},
"merchant": {
"id": "<string>",
"name": "<string>",
"city": "<string>",
"country": "FIN",
"zipCode": "<string>",
"address": "<string>",
"category": {
"code": "<string>",
"description": "<string>",
"group": "<string>"
},
"terminalId": "<string>",
"subMerchantId": "<string>",
"partialApprovalCapable": true,
"acquirerId": "<string>",
"acquirerCountry": "FIN",
"acquirerReferenceData": "<string>"
},
"transaction": {
"authCode": "<string>",
"authValidity": 123,
"issuerTransactionFees": [
{}
],
"cardholderVerificationMethods": [],
"retrievalReferenceNumber": "<string>",
"cardholderPresent": true,
"cardPresent": true,
"merchantInitiated": true,
"transactionDateTime": "2099-12-31T03:00:00.000",
"originalTransactionId": "<string>",
"processedDateTime": "2099-12-31T03:00:00.000Z"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageFunction": "REQUEST",
"token": {
"id": "<string>"
}
}
'import requests
url = "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth"
payload = {
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequenceNumber": 1,
"accountId": "<string>",
"cardholderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"groups": [{ "groupId": "<string>" }]
},
"merchant": {
"id": "<string>",
"name": "<string>",
"city": "<string>",
"country": "FIN",
"zipCode": "<string>",
"address": "<string>",
"category": {
"code": "<string>",
"description": "<string>",
"group": "<string>"
},
"terminalId": "<string>",
"subMerchantId": "<string>",
"partialApprovalCapable": True,
"acquirerId": "<string>",
"acquirerCountry": "FIN",
"acquirerReferenceData": "<string>"
},
"transaction": {
"authCode": "<string>",
"authValidity": 123,
"issuerTransactionFees": [{}],
"cardholderVerificationMethods": [],
"retrievalReferenceNumber": "<string>",
"cardholderPresent": True,
"cardPresent": True,
"merchantInitiated": True,
"transactionDateTime": "2099-12-31T03:00:00.000",
"originalTransactionId": "<string>",
"processedDateTime": "2099-12-31T03:00:00.000Z"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageFunction": "REQUEST",
"token": { "id": "<string>" }
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
card: {
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sequenceNumber: 1,
accountId: '<string>',
cardholderId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
groups: [{groupId: '<string>'}]
},
merchant: {
id: '<string>',
name: '<string>',
city: '<string>',
country: 'FIN',
zipCode: '<string>',
address: '<string>',
category: {code: '<string>', description: '<string>', group: '<string>'},
terminalId: '<string>',
subMerchantId: '<string>',
partialApprovalCapable: true,
acquirerId: '<string>',
acquirerCountry: 'FIN',
acquirerReferenceData: '<string>'
},
transaction: {
authCode: '<string>',
authValidity: 123,
issuerTransactionFees: [{}],
cardholderVerificationMethods: [],
retrievalReferenceNumber: '<string>',
cardholderPresent: true,
cardPresent: true,
merchantInitiated: true,
transactionDateTime: '2099-12-31T03:00:00.000',
originalTransactionId: '<string>',
processedDateTime: '2099-12-31T03:00:00.000Z'
},
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
transactionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
messageFunction: 'REQUEST',
token: {id: '<string>'}
})
};
fetch('https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'card' => [
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sequenceNumber' => 1,
'accountId' => '<string>',
'cardholderId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'groups' => [
[
'groupId' => '<string>'
]
]
],
'merchant' => [
'id' => '<string>',
'name' => '<string>',
'city' => '<string>',
'country' => 'FIN',
'zipCode' => '<string>',
'address' => '<string>',
'category' => [
'code' => '<string>',
'description' => '<string>',
'group' => '<string>'
],
'terminalId' => '<string>',
'subMerchantId' => '<string>',
'partialApprovalCapable' => true,
'acquirerId' => '<string>',
'acquirerCountry' => 'FIN',
'acquirerReferenceData' => '<string>'
],
'transaction' => [
'authCode' => '<string>',
'authValidity' => 123,
'issuerTransactionFees' => [
[
]
],
'cardholderVerificationMethods' => [
],
'retrievalReferenceNumber' => '<string>',
'cardholderPresent' => true,
'cardPresent' => true,
'merchantInitiated' => true,
'transactionDateTime' => '2099-12-31T03:00:00.000',
'originalTransactionId' => '<string>',
'processedDateTime' => '2099-12-31T03:00:00.000Z'
],
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'transactionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'messageFunction' => 'REQUEST',
'token' => [
'id' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth"
payload := strings.NewReader("{\n \"card\": {\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sequenceNumber\": 1,\n \"accountId\": \"<string>\",\n \"cardholderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"groups\": [\n {\n \"groupId\": \"<string>\"\n }\n ]\n },\n \"merchant\": {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"FIN\",\n \"zipCode\": \"<string>\",\n \"address\": \"<string>\",\n \"category\": {\n \"code\": \"<string>\",\n \"description\": \"<string>\",\n \"group\": \"<string>\"\n },\n \"terminalId\": \"<string>\",\n \"subMerchantId\": \"<string>\",\n \"partialApprovalCapable\": true,\n \"acquirerId\": \"<string>\",\n \"acquirerCountry\": \"FIN\",\n \"acquirerReferenceData\": \"<string>\"\n },\n \"transaction\": {\n \"authCode\": \"<string>\",\n \"authValidity\": 123,\n \"issuerTransactionFees\": [\n {}\n ],\n \"cardholderVerificationMethods\": [],\n \"retrievalReferenceNumber\": \"<string>\",\n \"cardholderPresent\": true,\n \"cardPresent\": true,\n \"merchantInitiated\": true,\n \"transactionDateTime\": \"2099-12-31T03:00:00.000\",\n \"originalTransactionId\": \"<string>\",\n \"processedDateTime\": \"2099-12-31T03:00:00.000Z\"\n },\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"messageFunction\": \"REQUEST\",\n \"token\": {\n \"id\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth")
.header("Content-Type", "application/json")
.body("{\n \"card\": {\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sequenceNumber\": 1,\n \"accountId\": \"<string>\",\n \"cardholderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"groups\": [\n {\n \"groupId\": \"<string>\"\n }\n ]\n },\n \"merchant\": {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"FIN\",\n \"zipCode\": \"<string>\",\n \"address\": \"<string>\",\n \"category\": {\n \"code\": \"<string>\",\n \"description\": \"<string>\",\n \"group\": \"<string>\"\n },\n \"terminalId\": \"<string>\",\n \"subMerchantId\": \"<string>\",\n \"partialApprovalCapable\": true,\n \"acquirerId\": \"<string>\",\n \"acquirerCountry\": \"FIN\",\n \"acquirerReferenceData\": \"<string>\"\n },\n \"transaction\": {\n \"authCode\": \"<string>\",\n \"authValidity\": 123,\n \"issuerTransactionFees\": [\n {}\n ],\n \"cardholderVerificationMethods\": [],\n \"retrievalReferenceNumber\": \"<string>\",\n \"cardholderPresent\": true,\n \"cardPresent\": true,\n \"merchantInitiated\": true,\n \"transactionDateTime\": \"2099-12-31T03:00:00.000\",\n \"originalTransactionId\": \"<string>\",\n \"processedDateTime\": \"2099-12-31T03:00:00.000Z\"\n },\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"messageFunction\": \"REQUEST\",\n \"token\": {\n \"id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"card\": {\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sequenceNumber\": 1,\n \"accountId\": \"<string>\",\n \"cardholderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"groups\": [\n {\n \"groupId\": \"<string>\"\n }\n ]\n },\n \"merchant\": {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"FIN\",\n \"zipCode\": \"<string>\",\n \"address\": \"<string>\",\n \"category\": {\n \"code\": \"<string>\",\n \"description\": \"<string>\",\n \"group\": \"<string>\"\n },\n \"terminalId\": \"<string>\",\n \"subMerchantId\": \"<string>\",\n \"partialApprovalCapable\": true,\n \"acquirerId\": \"<string>\",\n \"acquirerCountry\": \"FIN\",\n \"acquirerReferenceData\": \"<string>\"\n },\n \"transaction\": {\n \"authCode\": \"<string>\",\n \"authValidity\": 123,\n \"issuerTransactionFees\": [\n {}\n ],\n \"cardholderVerificationMethods\": [],\n \"retrievalReferenceNumber\": \"<string>\",\n \"cardholderPresent\": true,\n \"cardPresent\": true,\n \"merchantInitiated\": true,\n \"transactionDateTime\": \"2099-12-31T03:00:00.000\",\n \"originalTransactionId\": \"<string>\",\n \"processedDateTime\": \"2099-12-31T03:00:00.000Z\"\n },\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"messageFunction\": \"REQUEST\",\n \"token\": {\n \"id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"authResponseCode": "APPROVED",
"account": {
"availableAmount": {
"amount": 3.14,
"currency": "EUR"
}
},
"partialApprovalAmount": {
"amount": 3.14,
"currency": "EUR"
}
}Authorisation Request API
Authorisation Request API
Enfuce sends an authorisation request to the issuer/ledger, when it expects an authorisation decision from the recipient.
POST
/
auth
Authorisation Request API
curl --request POST \
--url 'https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth' \
--header 'Content-Type: application/json' \
--data '
{
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequenceNumber": 1,
"accountId": "<string>",
"cardholderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"groups": [
{
"groupId": "<string>"
}
]
},
"merchant": {
"id": "<string>",
"name": "<string>",
"city": "<string>",
"country": "FIN",
"zipCode": "<string>",
"address": "<string>",
"category": {
"code": "<string>",
"description": "<string>",
"group": "<string>"
},
"terminalId": "<string>",
"subMerchantId": "<string>",
"partialApprovalCapable": true,
"acquirerId": "<string>",
"acquirerCountry": "FIN",
"acquirerReferenceData": "<string>"
},
"transaction": {
"authCode": "<string>",
"authValidity": 123,
"issuerTransactionFees": [
{}
],
"cardholderVerificationMethods": [],
"retrievalReferenceNumber": "<string>",
"cardholderPresent": true,
"cardPresent": true,
"merchantInitiated": true,
"transactionDateTime": "2099-12-31T03:00:00.000",
"originalTransactionId": "<string>",
"processedDateTime": "2099-12-31T03:00:00.000Z"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageFunction": "REQUEST",
"token": {
"id": "<string>"
}
}
'import requests
url = "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth"
payload = {
"card": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequenceNumber": 1,
"accountId": "<string>",
"cardholderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"groups": [{ "groupId": "<string>" }]
},
"merchant": {
"id": "<string>",
"name": "<string>",
"city": "<string>",
"country": "FIN",
"zipCode": "<string>",
"address": "<string>",
"category": {
"code": "<string>",
"description": "<string>",
"group": "<string>"
},
"terminalId": "<string>",
"subMerchantId": "<string>",
"partialApprovalCapable": True,
"acquirerId": "<string>",
"acquirerCountry": "FIN",
"acquirerReferenceData": "<string>"
},
"transaction": {
"authCode": "<string>",
"authValidity": 123,
"issuerTransactionFees": [{}],
"cardholderVerificationMethods": [],
"retrievalReferenceNumber": "<string>",
"cardholderPresent": True,
"cardPresent": True,
"merchantInitiated": True,
"transactionDateTime": "2099-12-31T03:00:00.000",
"originalTransactionId": "<string>",
"processedDateTime": "2099-12-31T03:00:00.000Z"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageFunction": "REQUEST",
"token": { "id": "<string>" }
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
card: {
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
sequenceNumber: 1,
accountId: '<string>',
cardholderId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
groups: [{groupId: '<string>'}]
},
merchant: {
id: '<string>',
name: '<string>',
city: '<string>',
country: 'FIN',
zipCode: '<string>',
address: '<string>',
category: {code: '<string>', description: '<string>', group: '<string>'},
terminalId: '<string>',
subMerchantId: '<string>',
partialApprovalCapable: true,
acquirerId: '<string>',
acquirerCountry: 'FIN',
acquirerReferenceData: '<string>'
},
transaction: {
authCode: '<string>',
authValidity: 123,
issuerTransactionFees: [{}],
cardholderVerificationMethods: [],
retrievalReferenceNumber: '<string>',
cardholderPresent: true,
cardPresent: true,
merchantInitiated: true,
transactionDateTime: '2099-12-31T03:00:00.000',
originalTransactionId: '<string>',
processedDateTime: '2099-12-31T03:00:00.000Z'
},
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
transactionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
messageFunction: 'REQUEST',
token: {id: '<string>'}
})
};
fetch('https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'card' => [
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'sequenceNumber' => 1,
'accountId' => '<string>',
'cardholderId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'groups' => [
[
'groupId' => '<string>'
]
]
],
'merchant' => [
'id' => '<string>',
'name' => '<string>',
'city' => '<string>',
'country' => 'FIN',
'zipCode' => '<string>',
'address' => '<string>',
'category' => [
'code' => '<string>',
'description' => '<string>',
'group' => '<string>'
],
'terminalId' => '<string>',
'subMerchantId' => '<string>',
'partialApprovalCapable' => true,
'acquirerId' => '<string>',
'acquirerCountry' => 'FIN',
'acquirerReferenceData' => '<string>'
],
'transaction' => [
'authCode' => '<string>',
'authValidity' => 123,
'issuerTransactionFees' => [
[
]
],
'cardholderVerificationMethods' => [
],
'retrievalReferenceNumber' => '<string>',
'cardholderPresent' => true,
'cardPresent' => true,
'merchantInitiated' => true,
'transactionDateTime' => '2099-12-31T03:00:00.000',
'originalTransactionId' => '<string>',
'processedDateTime' => '2099-12-31T03:00:00.000Z'
],
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'transactionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'messageFunction' => 'REQUEST',
'token' => [
'id' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth"
payload := strings.NewReader("{\n \"card\": {\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sequenceNumber\": 1,\n \"accountId\": \"<string>\",\n \"cardholderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"groups\": [\n {\n \"groupId\": \"<string>\"\n }\n ]\n },\n \"merchant\": {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"FIN\",\n \"zipCode\": \"<string>\",\n \"address\": \"<string>\",\n \"category\": {\n \"code\": \"<string>\",\n \"description\": \"<string>\",\n \"group\": \"<string>\"\n },\n \"terminalId\": \"<string>\",\n \"subMerchantId\": \"<string>\",\n \"partialApprovalCapable\": true,\n \"acquirerId\": \"<string>\",\n \"acquirerCountry\": \"FIN\",\n \"acquirerReferenceData\": \"<string>\"\n },\n \"transaction\": {\n \"authCode\": \"<string>\",\n \"authValidity\": 123,\n \"issuerTransactionFees\": [\n {}\n ],\n \"cardholderVerificationMethods\": [],\n \"retrievalReferenceNumber\": \"<string>\",\n \"cardholderPresent\": true,\n \"cardPresent\": true,\n \"merchantInitiated\": true,\n \"transactionDateTime\": \"2099-12-31T03:00:00.000\",\n \"originalTransactionId\": \"<string>\",\n \"processedDateTime\": \"2099-12-31T03:00:00.000Z\"\n },\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"messageFunction\": \"REQUEST\",\n \"token\": {\n \"id\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth")
.header("Content-Type", "application/json")
.body("{\n \"card\": {\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sequenceNumber\": 1,\n \"accountId\": \"<string>\",\n \"cardholderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"groups\": [\n {\n \"groupId\": \"<string>\"\n }\n ]\n },\n \"merchant\": {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"FIN\",\n \"zipCode\": \"<string>\",\n \"address\": \"<string>\",\n \"category\": {\n \"code\": \"<string>\",\n \"description\": \"<string>\",\n \"group\": \"<string>\"\n },\n \"terminalId\": \"<string>\",\n \"subMerchantId\": \"<string>\",\n \"partialApprovalCapable\": true,\n \"acquirerId\": \"<string>\",\n \"acquirerCountry\": \"FIN\",\n \"acquirerReferenceData\": \"<string>\"\n },\n \"transaction\": {\n \"authCode\": \"<string>\",\n \"authValidity\": 123,\n \"issuerTransactionFees\": [\n {}\n ],\n \"cardholderVerificationMethods\": [],\n \"retrievalReferenceNumber\": \"<string>\",\n \"cardholderPresent\": true,\n \"cardPresent\": true,\n \"merchantInitiated\": true,\n \"transactionDateTime\": \"2099-12-31T03:00:00.000\",\n \"originalTransactionId\": \"<string>\",\n \"processedDateTime\": \"2099-12-31T03:00:00.000Z\"\n },\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"messageFunction\": \"REQUEST\",\n \"token\": {\n \"id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/processor/auth")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"card\": {\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"sequenceNumber\": 1,\n \"accountId\": \"<string>\",\n \"cardholderId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"groups\": [\n {\n \"groupId\": \"<string>\"\n }\n ]\n },\n \"merchant\": {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"city\": \"<string>\",\n \"country\": \"FIN\",\n \"zipCode\": \"<string>\",\n \"address\": \"<string>\",\n \"category\": {\n \"code\": \"<string>\",\n \"description\": \"<string>\",\n \"group\": \"<string>\"\n },\n \"terminalId\": \"<string>\",\n \"subMerchantId\": \"<string>\",\n \"partialApprovalCapable\": true,\n \"acquirerId\": \"<string>\",\n \"acquirerCountry\": \"FIN\",\n \"acquirerReferenceData\": \"<string>\"\n },\n \"transaction\": {\n \"authCode\": \"<string>\",\n \"authValidity\": 123,\n \"issuerTransactionFees\": [\n {}\n ],\n \"cardholderVerificationMethods\": [],\n \"retrievalReferenceNumber\": \"<string>\",\n \"cardholderPresent\": true,\n \"cardPresent\": true,\n \"merchantInitiated\": true,\n \"transactionDateTime\": \"2099-12-31T03:00:00.000\",\n \"originalTransactionId\": \"<string>\",\n \"processedDateTime\": \"2099-12-31T03:00:00.000Z\"\n },\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"messageFunction\": \"REQUEST\",\n \"token\": {\n \"id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"authResponseCode": "APPROVED",
"account": {
"availableAmount": {
"amount": 3.14,
"currency": "EUR"
}
},
"partialApprovalAmount": {
"amount": 3.14,
"currency": "EUR"
}
}Body
application/json
Information about the card used for the payment.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Unique system generated ID assigned to each event in the payment processing workflow. For example, an ID assigned to the initial authorisation event.
Enfuce generated unique ID assigned to each card transaction. Transaction events for the same card payment includes the same transactionId. For example, authorisation, incremental authorisation, and adjustment for the same transaction includes the same transactionID.
Message category sent in the authorisation control webhook. Possible enums:
- INITIAL_AUTHORIZATION: Initial authorisation of the card payment.
- INCREMENTAL_AUTHORIZATION: Additional authorisation for a previously authorised transaction.
- BALANCE_INQUIRY: Enquiring about the current balance of the funding account from the external application.
- PIN_MANAGEMENT: Request to change the card PIN.
Available options:
INITIAL_AUTHORIZATION, INCREMENTAL_AUTHORIZATION, BALANCE_INQUIRY, PIN_MANAGEMENT Identifies the message function of the authorisation request.
Available options:
REQUEST Information about the token associated with the card.
Show child attributes
Show child attributes
Response
200 - application/json
Indicates whether the authorisation request is approved or declined. Possible enums:
APPROVED- ApprovedPARTIALLY_APPROVED- Approved for partial amountDO_NOT_HONOR- Do not honor (Note: Card schemes recommend to use this only when other options do not apply)NOT_SUFFICIENT_FUNDS- Inadequate fundsNOT_PERMITTED- Transaction not permitted to cardholderEXCEEDS_AMOUNT_LIMIT- Exceeds approval amount limitRESTRICTED_CARD- Restricted card (card invalid in region or country)EXCEEDS_WITHDRAWAL_FREQUENCY_LIMIT- Exceeds withdrawal frequency limitSYSTEM_ERROR- System malfunction
Available options:
APPROVED, PARTIALLY_APPROVED, DO_NOT_HONOR, NOT_SUFFICIENT_FUNDS, NOT_PERMITTED, EXCEEDS_AMOUNT_LIMIT, RESTRICTED_CARD, EXCEEDS_WITHDRAWAL_FREQUENCY_LIMIT, SYSTEM_ERROR Show child attributes
Show child attributes
Return when there is a partial approval.
When the balance is less than the transaction amount, return the available amount that you authorise.
Return this attribute only when in the request merchant.partialApprovalCapable is true (i.e. the merchant
approves that a smaller amount than the full transaction amount is authorised), and authResponseCode
should be PARTIALLY_APPROVED.
Show child attributes
Show child attributes
Was this page helpful?
⌘I