Transaction event webhook
curl --request POST \
--url https://api.example.com/v1/transaction-events \
--header 'Content-Type: application/json' \
--data '
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"referenceTransactionEventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"reconciliationDate": "2099-12-31",
"reconciliationCycle": "<string>",
"exchangeRates": {
"ecbRate": 2.72
},
"partialClearingApplied": true,
"responseCode": "<string>"
},
"token": {
"id": "<string>"
}
}
'import requests
url = "https://api.example.com/v1/transaction-events"
payload = {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"referenceTransactionEventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"reconciliationDate": "2099-12-31",
"reconciliationCycle": "<string>",
"exchangeRates": { "ecbRate": 2.72 },
"partialClearingApplied": True,
"responseCode": "<string>"
},
"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({
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
referenceTransactionEventId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
transactionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
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',
reconciliationDate: '2099-12-31',
reconciliationCycle: '<string>',
exchangeRates: {ecbRate: 2.72},
partialClearingApplied: true,
responseCode: '<string>'
},
token: {id: '<string>'}
})
};
fetch('https://api.example.com/v1/transaction-events', 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.example.com/v1/transaction-events",
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([
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'referenceTransactionEventId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'transactionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'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',
'reconciliationDate' => '2099-12-31',
'reconciliationCycle' => '<string>',
'exchangeRates' => [
'ecbRate' => 2.72
],
'partialClearingApplied' => true,
'responseCode' => '<string>'
],
'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.example.com/v1/transaction-events"
payload := strings.NewReader("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"referenceTransactionEventId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"reconciliationDate\": \"2099-12-31\",\n \"reconciliationCycle\": \"<string>\",\n \"exchangeRates\": {\n \"ecbRate\": 2.72\n },\n \"partialClearingApplied\": true,\n \"responseCode\": \"<string>\"\n },\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.example.com/v1/transaction-events")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"referenceTransactionEventId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"reconciliationDate\": \"2099-12-31\",\n \"reconciliationCycle\": \"<string>\",\n \"exchangeRates\": {\n \"ecbRate\": 2.72\n },\n \"partialClearingApplied\": true,\n \"responseCode\": \"<string>\"\n },\n \"token\": {\n \"id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/transaction-events")
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 \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"referenceTransactionEventId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"reconciliationDate\": \"2099-12-31\",\n \"reconciliationCycle\": \"<string>\",\n \"exchangeRates\": {\n \"ecbRate\": 2.72\n },\n \"partialClearingApplied\": true,\n \"responseCode\": \"<string>\"\n },\n \"token\": {\n \"id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_bodyTransaction Event Webhook
Transaction event webhook
Enfuce sends a transaction event webhook to inform you about the current processing state. You might need to adjust the ledger balance, if impacted.
POST
/
v1
/
transaction-events
Transaction event webhook
curl --request POST \
--url https://api.example.com/v1/transaction-events \
--header 'Content-Type: application/json' \
--data '
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"referenceTransactionEventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"reconciliationDate": "2099-12-31",
"reconciliationCycle": "<string>",
"exchangeRates": {
"ecbRate": 2.72
},
"partialClearingApplied": true,
"responseCode": "<string>"
},
"token": {
"id": "<string>"
}
}
'import requests
url = "https://api.example.com/v1/transaction-events"
payload = {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"referenceTransactionEventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"reconciliationDate": "2099-12-31",
"reconciliationCycle": "<string>",
"exchangeRates": { "ecbRate": 2.72 },
"partialClearingApplied": True,
"responseCode": "<string>"
},
"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({
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
referenceTransactionEventId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
transactionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
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',
reconciliationDate: '2099-12-31',
reconciliationCycle: '<string>',
exchangeRates: {ecbRate: 2.72},
partialClearingApplied: true,
responseCode: '<string>'
},
token: {id: '<string>'}
})
};
fetch('https://api.example.com/v1/transaction-events', 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.example.com/v1/transaction-events",
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([
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'referenceTransactionEventId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'transactionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'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',
'reconciliationDate' => '2099-12-31',
'reconciliationCycle' => '<string>',
'exchangeRates' => [
'ecbRate' => 2.72
],
'partialClearingApplied' => true,
'responseCode' => '<string>'
],
'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.example.com/v1/transaction-events"
payload := strings.NewReader("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"referenceTransactionEventId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"reconciliationDate\": \"2099-12-31\",\n \"reconciliationCycle\": \"<string>\",\n \"exchangeRates\": {\n \"ecbRate\": 2.72\n },\n \"partialClearingApplied\": true,\n \"responseCode\": \"<string>\"\n },\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.example.com/v1/transaction-events")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"referenceTransactionEventId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"reconciliationDate\": \"2099-12-31\",\n \"reconciliationCycle\": \"<string>\",\n \"exchangeRates\": {\n \"ecbRate\": 2.72\n },\n \"partialClearingApplied\": true,\n \"responseCode\": \"<string>\"\n },\n \"token\": {\n \"id\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/transaction-events")
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 \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"referenceTransactionEventId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"transactionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"reconciliationDate\": \"2099-12-31\",\n \"reconciliationCycle\": \"<string>\",\n \"exchangeRates\": {\n \"ecbRate\": 2.72\n },\n \"partialClearingApplied\": true,\n \"responseCode\": \"<string>\"\n },\n \"token\": {\n \"id\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_bodyDownload OpenAPI specification
Body
application/json
Unique system generated ID assigned to each event in the payment processing workflow. For example, an ID assigned to the initial authorisation event.
Unique ID assigned to VOID_AUTHORIZATION message category — applicable only for VOID_AUTHORIZATION.
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 transaction event webhook. Possible enums:
- INITIAL_AUTHORIZATION: Initial authorisation of the card payment.
- INCREMENTAL_AUTHORIZATION: Additional authorisation for a previously authorised transaction.
- DECLINED_AUTHORIZATION: Scheme declined the transaction on behalf of Enfuce in the STIP mode.
- ADJUSTMENT: Corrections to a previously authorised transaction.
- REVERSAL: Reversal of 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.
- PIN_MANAGEMENT_REVERSAL: Reversal of a pin change request.
- FINANCIAL: Clearing message of batch payments.
- PURGE_AUTHORIZATION: Excluded authorisations are purged after a specific period.
- VOID_AUTHORIZATION: When an initial authorisation or an incremental authorisation request times out, a
VOID_AUTHORIZATIONmessage is generated. - ACCOUNT_STATUS_INQUIRY: When an account status is requested.
Available options:
INITIAL_AUTHORIZATION, INCREMENTAL_AUTHORIZATION, DECLINED_AUTHORIZATION, ADJUSTMENT, REVERSAL, BALANCE_INQUIRY, PIN_MANAGEMENT, PIN_MANAGEMENT_REVERSAL, FINANCIAL, FINANCIAL_ADDENDUM, FEE_COLLECTION, RECONCILIATION, PURGE_AUTHORIZATION, VOID_AUTHORIZATION, CHARGEBACK, CHARGEBACK_REVERSAL, REPRESENTMENT, REPRESENTMENT_REVERSAL, DOCUMENT_REQUEST, ACCOUNT_STATUS_INQUIRY Identifies the message function of the transaction event.
Available options:
REQUEST, ADVICE, NOTIFICATION, ACCOUNT_STATUS_INQUIRY The status of the transaction. CLEARED means that the transaction has been fully cleared, PARTIALLY_CLEARED means that the transaction is partially cleared.
Available options:
CLEARED, PARTIALLY_CLEARED 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
Information about the token associated with the card.
Show child attributes
Show child attributes
Response
Webhook successfully delivered.
Was this page helpful?
⌘I