Card Transactions
Card Transaction Types
- Payment
- Refund
- Chargeback
- ATM Withdrawal
- Money Transfer
Card Transaction Statuses
- Authorised
- Settled
- Reversed
- Declined
Note: The enrichment field in the transaction JSON is optional and will only be populated if a card transaction enrichment provider is enabled for the account or transaction. This field contains enriched data related to the merchant, payment processor, and transaction, such as the merchant's name, address, categories, and contact details. The data is typically retrieved from third-party sources that provide additional context to the transaction.
If the card transaction enrichment service is not enabled, the enrichment field will be empty. When enabled, this field is filled with relevant details to enhance the understanding of the transaction, improve reporting or other value-added services.
Get a Card Transaction
GET /card-transactions/{cardTransactionId}
{
"workflow": {},
"data": {
"cardTransaction": {
"id": "9fbdfd66-0d1d-47d8-9e29-7c2c38abba8e",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20210301-ABC123",
"type": "payment",
"status": "settled",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": -1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "TfL Transport Travel Charge tfl.gov.uk/cp",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxId",
"address": {
"country": "GB",
"postalCode": "N42 0TO",
"city": "London",
"street": "26 Station Road"
},
"phone": "+44 20 7946 0350",
"website": "website",
"category": {
"code": "4111",
"description": "Commuter Transport, Ferries"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "oob-biometric"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-03-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Transport for London",
"logoUrl": "https://example.com/tfl.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+448001234567",
"email": "[email protected]",
"website": "https://tfl.gov.uk"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Commute"
},
"paymentProcessor": {
"name": "Stripe",
"logoUrl": "https://example.com/stripe-logo.png"
}
}
}
},
"connect": {},
"metadata": {}
}
List Card Transactions
GET /card-transactions
Supported query parameters:
| parameter | description |
|---|---|
| metadata.page.number | 0-indexed, default=0 |
| metadata.page.size | default=10 |
| data.cardTransaction.cardId | ID of the card |
| data.cardTransaction.clientId | ID of the client |
| data.cardTransaction.accountId | ID of the account |
| data.cardTransaction.type | payment, refund, chargeback, atm-withdrawal, money-transfer |
| data.cardTransaction.status | authorised, settled, reversed, declined |
| data.cardTransaction.transactionNumber | transaction number |
| data.cardTransaction.transactionCurrency | transaction currency |
| data.cardTransaction.description | transaction description |
| data.cardTransaction.reason | transaction reason |
| data.cardTransaction.maxAmount | |
| data.cardTransaction.minAmount | |
| data.cardTransaction.creationDateFrom | |
| data.cardTransaction.creationDateTo | |
| data.cardTransaction.serviceProvider | service provider of the card transaction |
| data.cardTransaction.serviceProviderId | service provider ID of the card transaction |
| data.cardTransaction.serviceProviderReference | service provider reference of the card transaction |
{
"workflow": {},
"data": {
"cardTransactions": [{
"id": "9fbdfd66-0d1d-47d8-9e29-7c2c38abba8e",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20240301-ABC123",
"type": "payment",
"status": "settled",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": -1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "Commuter Transport",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxId",
"address": {
"country": "GB",
"region": "England",
"city": "London",
"street": "Baker Street",
"houseNumber": "221B",
"postalCode": "XYZ ABC",
"refinement": ""
},
"phone": "+441234567890",
"website": "[email protected]",
"category": {
"code": "4111",
"description": "Commuter Transport, Ferries"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "oob-biometric"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-03-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Transport for London",
"logoUrl": "https://example.com/tfl.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+448001234567",
"email": "[email protected]",
"website": "https://tfl.gov.uk"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Commute"
},
"paymentProcessor": {
"name": "Stripe",
"logoUrl": "https://example.com/stripe-logo.png"
}
}
},
{
"id": "522e2cd8-734b-4631-9180-fc35057c449a",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20240101-ABC123",
"type": "payment",
"status": "authorised",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": -1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "FORUM HOTELS",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxıd",
"address": {
"country": "GB",
"region": "England",
"city": "London",
"street": "Baker Street",
"houseNumber": "221B",
"postalCode": "XYZ ABC",
"refinement": ""
},
"phone": "+441234567890",
"website": "[email protected]",
"category": {
"code": "3570",
"description": "FORUM HOTELS"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "no-authentication"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-01-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Forum Hotels",
"logoUrl": "https://example.com/forum-hotels.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+441234567890",
"email": "[email protected]",
"website": "https://forumhotels.com"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Hotel"
},
"paymentProcessor": {
"name": "Paypal",
"logoUrl": "https://example.com/paypal-logo.png"
}
}
}
]
},
"connect": {},
"metadata": {
"page": {
"size": 20,
"number": 0,
"totalElements": 5,
"totalPages": 1
}
}
}
Webhooks
Webhook types:
- card-transaction-created
- card-transaction-settled
- card-transaction-reversed
- card-transaction-authorisation-updated
- card-transaction-declined
{
"webhook": {
"module": "card-transactions",
"type": "card-transaction-created"
},
"data": {
"cardTransaction": {
"id": "522e2cd8-734b-4631-9180-fc35057c449a",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20240101-ABC123",
"type": "payment",
"status": "authorised",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": -1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "FORUM HOTELS",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxıd",
"address": {
"country": "GB",
"region": "England",
"city": "London",
"street": "Baker Street",
"houseNumber": "221B",
"postalCode": "XYZ ABC",
"refinement": ""
},
"phone": "+441234567890",
"website": "[email protected]",
"category": {
"code": "3570",
"description": "FORUM HOTELS"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "no-authentication"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-01-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Forum Hotels",
"logoUrl": "https://example.com/forum-hotels.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+441234567890",
"email": "[email protected]",
"website": "https://forumhotels.com"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Hotel"
},
"paymentProcessor": {
"name": "Paypal",
"logoUrl": "https://example.com/paypal-logo.png"
}
}
}
},
"connect": {},
"metadata": {}
}
{
"webhook": {
"module": "card-transactions",
"type": "card-transaction-settled"
},
"data": {
"cardTransaction": {
"id": "522e2cd8-734b-4631-9180-fc35057c449a",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20240101-ABC123",
"type": "payment",
"status": "settled",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": 1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "FORUM HOTELS",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxıd",
"address": {
"country": "GB",
"region": "England",
"city": "London",
"street": "Baker Street",
"houseNumber": "221B",
"postalCode": "XYZ ABC",
"refinement": ""
},
"phone": "+441234567890",
"website": "[email protected]",
"category": {
"code": "3570",
"description": "FORUM HOTELS"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "no-authentication"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-01-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Forum Hotels",
"logoUrl": "https://example.com/forum-hotels.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+441234567890",
"email": "[email protected]",
"website": "https://forumhotels.com"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Hotel"
},
"paymentProcessor": {
"name": "Paypal",
"logoUrl": "https://example.com/paypal-logo.png"
}
}
}
},
"connect": {},
"metadata": {}
}
{
"webhook": {
"module": "card-transactions",
"type": "card-transaction-reversed"
},
"data": {
"cardTransaction": {
"id": "522e2cd8-734b-4631-9180-fc35057c449a",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20240101-ABC123",
"type": "payment",
"status": "reversed",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": 1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "FORUM HOTELS",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxıd",
"address": {
"country": "GB",
"region": "England",
"city": "London",
"street": "Baker Street",
"houseNumber": "221B",
"postalCode": "XYZ ABC",
"refinement": ""
},
"phone": "+441234567890",
"website": "[email protected]",
"category": {
"code": "3570",
"description": "FORUM HOTELS"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "no-authentication"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-01-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Forum Hotels",
"logoUrl": "https://example.com/forum-hotels.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+441234567890",
"email": "[email protected]",
"website": "https://forumhotels.com"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Hotel"
},
"paymentProcessor": {
"name": "Paypal",
"logoUrl": "https://example.com/paypal-logo.png"
}
}
}
},
"connect": {},
"metadata": {}
}
{
"webhook": {
"module": "card-transactions",
"type": "card-transaction-authorisation-updated"
},
"data": {
"cardTransaction": {
"id": "522e2cd8-734b-4631-9180-fc35057c449a",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20240101-ABC123",
"type": "payment",
"status": "authorised",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": 1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "FORUM HOTELS",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxıd",
"address": {
"country": "GB",
"region": "England",
"city": "London",
"street": "Baker Street",
"houseNumber": "221B",
"postalCode": "XYZ ABC",
"refinement": ""
},
"phone": "+441234567890",
"website": "[email protected]",
"category": {
"code": "3570",
"description": "FORUM HOTELS"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "no-authentication"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-01-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Forum Hotels",
"logoUrl": "https://example.com/forum-hotels.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+441234567890",
"email": "[email protected]",
"website": "https://forumhotels.com"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Hotel"
},
"paymentProcessor": {
"name": "Paypal",
"logoUrl": "https://example.com/paypal-logo.png"
}
}
}
},
"connect": {},
"metadata": {}
}
{
"webhook": {
"module": "card-transactions",
"type": "card-transaction-declined"
},
"data": {
"cardTransaction": {
"id": "522e2cd8-734b-4631-9180-fc35057c449a",
"cardId": "491c55ac-21ac-4e8a-bac6-ac9ef2b40c31",
"clientId": "aa5e7c73-3bcf-4698-8619-9377915d6a96",
"matchingTransactionId": null,
"accountId": "28e423eb-04d4-4e07-8e4f-5614ffe5a6ae",
"accountCurrency": "EUR",
"transactionNumber": "20240101-ABC123",
"type": "payment",
"status": "declined",
"transactionAmount": 100.00,
"transactionCurrency": "EUR",
"feeAmount": 10.00,
"feeCurrency": "EUR",
"billingAmount": 1.00,
"billingCurrency": "EUR",
"settlementAmount": 100.00,
"settlementCurrency": "EUR",
"effectiveTransactionAmount": 100.00,
"effectiveFeeAmount": 10.00,
"transactionExchangeRate": null,
"feeExchangeRate": null,
"merchant": {
"name": "FORUM HOTELS",
"id": "merchantId",
"networkId": "networkId",
"taxId": "taxıd",
"address": {
"country": "GB",
"region": "England",
"city": "London",
"street": "Baker Street",
"houseNumber": "221B",
"postalCode": "XYZ ABC",
"refinement": ""
},
"phone": "+441234567890",
"website": "[email protected]",
"category": {
"code": "3570",
"description": "FORUM HOTELS"
}
},
"pos": {
"cardholderPresent": null,
"cardPresent": null,
"cardDataInputMethod": null,
"authentication": null,
"chipFallback": null,
"fraud": null,
"securityProtocol": null,
"cardAuthentication3DSecureMethod": "no-authentication"
},
"serviceProvider": "THD",
"serviceProviderEntityId": "00000000-0000-0000-0000-000000000000",
"serviceProviderEntityReference": "reference",
"description": "description",
"reason": "reason",
"direction": "debit",
"totalAmount": 110.00,
"creationDateTime": "2024-01-01T10:00:00",
"enrichment": {
"merchant": {
"brandName": "Forum Hotels",
"logoUrl": "https://example.com/forum-hotels.png",
"latitude": "40.7128",
"longitude": "-74.0060",
"country": "GB",
"city": "London",
"zipCode": "SE1 5AA",
"street": "London Bridge",
"phone": "+441234567890",
"email": "[email protected]",
"website": "https://forumhotels.com"
},
"recurringPayment": true,
"category": {
"primary": "Travel",
"secondary": "Hotel"
},
"paymentProcessor": {
"name": "Paypal",
"logoUrl": "https://example.com/paypal-logo.png"
}
}
}
},
"connect": {},
"metadata": {}
}
Updated about 1 month ago