In order to enrich your transactions with data from your POS, PMS, Webshop or similar system you will need to transfer the transaction details to us. This can be done by uploading a file to our SFTP-server. We're working on a solution to allow uploads via a simple API-call which will validate the data as you upload it in order to get a quicker feedback-loop.
The JSON-format is identical to the one used in our Business API.
Important considerations
- Phone numbers must always be prefixed with a country code
- Either
memberIdormemberPhoneNumbermust be provided - Booking information is optional
See the following example:
{
"merchantId": 9999,
"programId": 4321,
"memberId": 1234,
"memberPhoneNumber": "4799887766",
"seller": "Ola Nordmann",
"storeName": "My Awesome Store",
"externalOrderId": "other-order-id-or-reference-1234",
"transactionType": "SALE",
"bonusReservationReference": "cb054d0e-ce23-4eb5-8967-5623883a6ff2",
"payment": {
"paymentType": "VISA",
"terminalId": 665544,
"baxNumber": 998877,
"maskedPan": "8101******99",
"transactionReference": "121212",
"transactionAuthCode": "434343",
"transactionSum": 1000,
"vatCode": "0.250"
},
"transactionLines": [
{
"count": 99,
"outValueSum": 500,
"supplierName": "Polo",
"supplierNumber": "232323",
"inValueSum": 0,
"itemNo": "321",
"productName": "Polo",
"productGroupName": "Sweater",
"productGroupNumber": 676767,
"bonusValidFrom": "2021-12-09T12:04:10.8770757+01:00",
"isRefundable": true,
"bookingInformation": {
"bookingReference": "my-booking-reference",
"arrivalDate": "2022-01-08T12:04:10.8770757+01:00",
"departureDate": "2022-01-15T12:04:10.8770757+01:00",
"numberOfPeople": 1
},
"orderLineReference": "my-order-line-reference",
"packageReference": "my-package-reference"
},
{
"count": 3,
"outValueSum": 300,
"supplierName": "Offbrand Supplier",
"supplierNumber": "1234",
"inValueSum": 0,
"itemNo": "123",
"productName": "Superman Sneakers",
"productGroupName": "Shoes",
"productGroupNumber": 99,
"bonusValidFrom": "2021-12-09T12:04:10.8770757+01:00",
"isRefundable": true,
"bookingInformation": {
"bookingReference": "my-booking-reference",
"arrivalDate": "2022-01-08T12:04:10.8770757+01:00",
"departureDate": "2022-01-15T12:04:10.8770757+01:00",
"numberOfPeople": 1
},
"orderLineReference": "my-order-line-reference-2",
"packageReference": "my-package-reference",
"parentOrderLineReference": "my-order-line-reference"
}
]
}