Download OpenAPI specification:Download
Contains all settings that are universally valid for the merchant. One merchant can have multiple contracts, and multiple stores.
Returns the General Merchants matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching General Merchants
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 23,
- "data": [
- {
- "object": "general.merchants",
- "id": "MRC_1HVSZKD4LQ44D9AUX2JZ6S1OPS3G9B",
- "id_old": 2332534,
- "user": {
- "companyname": "Musterhändler GbR",
- "project_name": null,
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "1 b",
- "short_name": "1 b",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstr.",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstr. 1 b, 09123 Musterstadt, Germany"
}
], - "email": [
- {
- "type": "invoice",
- "email_formatted": "max@example.com"
}
]
}, - "type": 46,
- "store_name": null,
- "parent": {
- "object": "general.merchants",
- "id": "MRC_SZ7LGS00KNJEU8UKTBB2XDSIDDPVNP",
- "type": 21
}
}, - {
- "object": "general.merchants",
- "id": "MRC_AHV6HB6J985BW5KXYIY0AWBGP8UE20",
- "id_old": 2012106,
- "user": {
- "companyname": "Beispielfirma GmbH & Co. KG",
- "project_name": null,
- "name": "Barbara Beispiel",
- "forename": "Barbara",
- "surname": "Beispiel",
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "14-16",
- "short_name": "14-16",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Beispielstr.",
- "short_name": "Beispielstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Beispielstädt",
- "short_name": "Beispielstädt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09321",
- "short_name": "09321",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Beispielstr. 14-16, 09321 Beispielstädt, Germany"
}
], - "email": [
- {
- "type": "invoice",
- "email_formatted": "barbara@beispeil.de"
}
]
}, - "type": 46,
- "store_name": null,
- "parent": {
- "object": "general.merchants",
- "id": "MRC_SZ7LGS00KNJEU8UKTBB2XDSIDDPVNP",
- "type": 21
}, - "assigned_by": [
- {
- "object": "general.accounts",
- "id": "ACC_X9T3270BJF2Z1OENLEA826FL9LA6SU",
- "owner": true
}
]
}
]
}
Returns the specified General Merchant.
generalMerchantId required | string General Merchant ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
General Merchant
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "general.merchants",
- "id": "MRC_1HVSZKD4LQ44D9AUX2JZ6S1OPS3G9B",
- "id_old": 2332534,
- "user": {
- "companyname": "Musterhändler GbR",
- "project_name": null,
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "1 b",
- "short_name": "1 b",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstr.",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstr. 1 b, 09123 Musterstadt, Germany"
}
], - "email": [
- {
- "type": "invoice",
- "email_formatted": "max@example.com"
}
]
}, - "type": 46,
- "store_name": null,
- "parent": {
- "object": "general.merchants",
- "id": "MRC_SZ7LGS00KNJEU8UKTBB2XDSIDDPVNP",
- "type": 21
}
}
Updates the specified General Merchant with the given data.
generalMerchantId required | string General Merchant ID |
Merchant details
legal_details | Array of objects (GeneralMerchantsLegalDetailsDTO) Nullable Legal details like terms of use, privacy policy, or imprint |
urls | Array of objects (GeneralMerchantsUrls) Nullable Return URLs |
Updated General Merchant
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "legal_details": [
- {
- "type": "terms",
- "content": "Test",
- "content-type": "text/plain",
- "language": "de"
}
]
}
{- "object": "general.merchants",
- "id": "MRC_1HVSZKD4LQ44D9AUX2JZ6S1OPS3G9B",
- "id_old": 2332534,
- "user": {
- "companyname": "Musterhändler GbR",
- "project_name": null,
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "1 b",
- "short_name": "1 b",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstr.",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstr. 1 b, 09123 Musterstadt, Germany"
}
], - "email": [
- {
- "type": "invoice",
- "email_formatted": "max@example.com"
}
]
}, - "type": 46,
- "store_name": null,
- "parent": {
- "object": "general.merchants",
- "id": "MRC_SZ7LGS00KNJEU8UKTBB2XDSIDDPVNP",
- "type": 21
}, - "legal_details": [
- {
- "type": "terms",
- "content_type": "text/html",
- "language": "de"
}
]
}
Returns the public data of the specified General Merchant and General Contract.
generalMerchantId required | string General Merchant ID |
generalContractId required | string General Contract ID |
General Merchant's public data
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "legal_details": null,
- "company": {
- "companyname": "Musterfirma GmbH",
- "address": {
- "address_components": [
- {
- "long_name": "12 a",
- "short_name": "12 a",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstraße",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstraße 12 a, 09123 Musterstadt, Germany",
- "geometry": {
- "lat": "51.123456",
- "lon": "14.123456"
}
}
}, - "merchant_urls": null,
- "checkout_options": null
}
Returns the available merchant categories for the authenticated merchant.
Available Merchants Categories
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
[- {
- "id": 1,
- "description": "Tierarzt"
}, - {
- "id": 2,
- "description": "Landwirtschaftl.Genos."
}, - {
- "id": 3,
- "description": "Landmaschinen"
}, - {
- "id": 4,
- "description": "Garten- und Landschaftsbau"
}, - {
- "id": 5,
- "description": "Heizungsinstallateur"
}, - {
- "id": 6,
- "description": "Elektriker"
}, - {
- "id": 7,
- "description": "Beleuchtungstechnik"
}, - {
- "id": 8,
- "description": "Fliesenleger"
}, - {
- "id": 9,
- "description": "Schreiner"
}, - {
- "id": 10,
- "description": "Dachdecker"
}, - {
- "id": 11,
- "description": "Betonarbeiten"
}, - {
- "id": 12,
- "description": "Handwerk"
}, - {
- "id": 13,
- "description": "Bauhandwerk"
}, - {
- "id": 14,
- "description": "Druckservice"
}, - {
- "id": 15,
- "description": "Druckertankstelle"
}, - {
- "id": 16,
- "description": "Oeffentl.Verkehrsmittel"
}, - {
- "id": 17,
- "description": "Eisenbahn"
}, - {
- "id": 18,
- "description": "Krankenwagendienste"
}, - {
- "id": 19,
- "description": "Taxi"
}, - {
- "id": 20,
- "description": "Busunternehmen"
}, - {
- "id": 21,
- "description": "Spedition"
}, - {
- "id": 22,
- "description": "Kurierdienst"
}, - {
- "id": 23,
- "description": "Kreuzfahrtgesellschaft"
}, - {
- "id": 24,
- "description": "Bootsvermietung"
}, - {
- "id": 25,
- "description": "Yachthäfen, Hafendienstleistung und Zube"
}, - {
- "id": 26,
- "description": "Airline"
}, - {
- "id": 27,
- "description": "Flughäfen, Flugplätze und Flughafentermi"
}, - {
- "id": 28,
- "description": "Reisebüro"
}, - {
- "id": 29,
- "description": "Strassennutzungsgeb."
}, - {
- "id": 30,
- "description": "Verwaltung"
}, - {
- "id": 31,
- "description": "Verkehrsdienst"
}, - {
- "id": 32,
- "description": "Telekommunikation"
}, - {
- "id": 33,
- "description": "Telefon-Provider"
}, - {
- "id": 34,
- "description": "Internet Serv.Provider"
}, - {
- "id": 35,
- "description": "Online-Dienstleistungen"
}, - {
- "id": 36,
- "description": "Onlineshop"
}, - {
- "id": 37,
- "description": "Kabel, Sat. Pay-TV"
}, - {
- "id": 38,
- "description": "Fernsehtechnik"
}, - {
- "id": 39,
- "description": "Autozubehoer"
}, - {
- "id": 40,
- "description": "Bueromoebel"
}, - {
- "id": 41,
- "description": "Photographie"
}, - {
- "id": 42,
- "description": "Computer-Equipment"
}, - {
- "id": 43,
- "description": "Handelsausstattung"
}, - {
- "id": 44,
- "description": "Dentallabor"
}, - {
- "id": 45,
- "description": "Metall Service Center"
}, - {
- "id": 46,
- "description": "Industrielieferant"
}, - {
- "id": 47,
- "description": "Baumaschinen"
}, - {
- "id": 48,
- "description": "Maschinenbau"
}, - {
- "id": 49,
- "description": "Import Holzprodukte"
}, - {
- "id": 50,
- "description": "Bürobedarf"
}, - {
- "id": 51,
- "description": "Drogerie"
}, - {
- "id": 52,
- "description": "Kurzwaren"
}, - {
- "id": 53,
- "description": "Schuhhandel"
}, - {
- "id": 54,
- "description": "Chemie"
}, - {
- "id": 55,
- "description": "Mineralölhandel"
}, - {
- "id": 56,
- "description": "Brennstoffhandel"
}, - {
- "id": 57,
- "description": "Verlag"
}, - {
- "id": 58,
- "description": "Blumenhaus/Floristik"
}, - {
- "id": 59,
- "description": "Farben und Zubehör"
}, - {
- "id": 60,
- "description": "Konsumgueter"
}, - {
- "id": 61,
- "description": "Lagerverkauf"
}, - {
- "id": 62,
- "description": "Baumarkt"
}, - {
- "id": 63,
- "description": "Eisenwaren"
}, - {
- "id": 64,
- "description": "Farben-/Tapetengesch."
}, - {
- "id": 65,
- "description": "Computer"
}, - {
- "id": 66,
- "description": "Gartencenter"
}, - {
- "id": 67,
- "description": "Mobiler Heimverkauf"
}, - {
- "id": 68,
- "description": "Großhandel"
}, - {
- "id": 69,
- "description": "Dutyfree Shop"
}, - {
- "id": 70,
- "description": "Marktbetreiber"
}, - {
- "id": 71,
- "description": "Kaufhaus"
}, - {
- "id": 72,
- "description": "Merchandiseig."
}, - {
- "id": 73,
- "description": "Lebensmittel"
}, - {
- "id": 74,
- "description": "Fleischerei"
}, - {
- "id": 75,
- "description": "Suesswaren"
}, - {
- "id": 76,
- "description": "Bäckerei"
}, - {
- "id": 77,
- "description": "Autohaus"
}, - {
- "id": 78,
- "description": "Auto"
}, - {
- "id": 79,
- "description": "Autohandel"
}, - {
- "id": 80,
- "description": "Neu- und Gebrauchtfahrzeughandel"
}, - {
- "id": 81,
- "description": "Kfz.Zubehoer"
}, - {
- "id": 82,
- "description": "Tankstelle"
}, - {
- "id": 83,
- "description": "autom.Tankstelle"
}, - {
- "id": 84,
- "description": "Bootshändler/-verkäufer"
}, - {
- "id": 85,
- "description": "Bootszubehör"
}, - {
- "id": 86,
- "description": "Wassersportzubehör"
}, - {
- "id": 87,
- "description": "Wohnmobile"
}, - {
- "id": 88,
- "description": "Motorradhandel"
}, - {
- "id": 89,
- "description": "Motor Home Dealers"
}, - {
- "id": 90,
- "description": "Flugzeug- und Agrarausstattung"
}, - {
- "id": 91,
- "description": "Herrenmode"
}, - {
- "id": 92,
- "description": "Damenmode"
}, - {
- "id": 93,
- "description": "Jeans und Sportswear"
}, - {
- "id": 94,
- "description": "Kindermode"
}, - {
- "id": 95,
- "description": "Sportmode"
}, - {
- "id": 96,
- "description": "Pelzhaus"
}, - {
- "id": 97,
- "description": "Bekleidung"
}, - {
- "id": 98,
- "description": "Textilverkauf"
}, - {
- "id": 99,
- "description": "Aenderungs- u. Maßschneider"
}, - {
- "id": 100,
- "description": "Perücken und Toupe Geschäft"
}, - {
- "id": 101,
- "description": "Modeaccessoires"
}, - {
- "id": 102,
- "description": "Einrichtungshaus"
}, - {
- "id": 103,
- "description": "Küchenstudio"
}, - {
- "id": 104,
- "description": "Teppichhaus"
}, - {
- "id": 105,
- "description": "Wasserbetten"
}, - {
- "id": 106,
- "description": "Kamine und Kaminzubehör"
}, - {
- "id": 107,
- "description": "Haushaltwaren"
}, - {
- "id": 108,
- "description": "Elektrowaren"
}, - {
- "id": 109,
- "description": "Hausgeräte"
}, - {
- "id": 110,
- "description": "Haustechnik"
}, - {
- "id": 111,
- "description": "Unterhaltungselektr."
}, - {
- "id": 112,
- "description": "Musikhandel"
}, - {
- "id": 113,
- "description": "Musikinstrumente"
}, - {
- "id": 114,
- "description": "Software"
}, - {
- "id": 115,
- "description": "Partyservice"
}, - {
- "id": 116,
- "description": "Restaurant"
}, - {
- "id": 117,
- "description": "Café"
}, - {
- "id": 118,
- "description": "Fast Food Restaurant"
}, - {
- "id": 119,
- "description": "Apotheke"
}, - {
- "id": 120,
- "description": "Getränkehandel"
}, - {
- "id": 121,
- "description": "An- und Verkauf"
}, - {
- "id": 122,
- "description": "Antiquitäten"
}, - {
- "id": 123,
- "description": "Pfandbüro"
}, - {
- "id": 124,
- "description": "Bergungsdienste, Rettungskosten"
}, - {
- "id": 125,
- "description": "Zweirad"
}, - {
- "id": 126,
- "description": "Fahrradhandel"
}, - {
- "id": 127,
- "description": "Sportartikel"
}, - {
- "id": 128,
- "description": "Waffen"
}, - {
- "id": 129,
- "description": "Buchladen"
}, - {
- "id": 130,
- "description": "Buchhandel"
}, - {
- "id": 131,
- "description": "Schreibwaren"
}, - {
- "id": 132,
- "description": "Juwelier"
}, - {
- "id": 133,
- "description": "Schmuck"
}, - {
- "id": 134,
- "description": "Spielwaren"
}, - {
- "id": 135,
- "description": "Babybedarf"
}, - {
- "id": 136,
- "description": "Modellbau"
}, - {
- "id": 137,
- "description": "Foto"
}, - {
- "id": 138,
- "description": "Geschenkartikel"
}, - {
- "id": 139,
- "description": "Lederwaren"
}, - {
- "id": 140,
- "description": "Sattlerei"
}, - {
- "id": 141,
- "description": "Handarbeitsgeschaeft"
}, - {
- "id": 142,
- "description": "Glaserei"
}, - {
- "id": 143,
- "description": "Direktvertrieb"
}, - {
- "id": 144,
- "description": "Handelsvertreter"
}, - {
- "id": 145,
- "description": "Mailorder"
}, - {
- "id": 146,
- "description": "Kataloghaendler"
}, - {
- "id": 147,
- "description": "Outbound Telemarking"
}, - {
- "id": 148,
- "description": "Erotik"
}, - {
- "id": 149,
- "description": "Direct Marketing"
}, - {
- "id": 150,
- "description": "Kunstgewerbe"
}, - {
- "id": 151,
- "description": "Frottierweberei"
}, - {
- "id": 152,
- "description": "Kunsthandwerk"
}, - {
- "id": 153,
- "description": "Keramik"
}, - {
- "id": 154,
- "description": "Galerie"
}, - {
- "id": 155,
- "description": "Kunsthandel"
}, - {
- "id": 156,
- "description": "Briefmarken/-Muenzen"
}, - {
- "id": 157,
- "description": "Briefmarken"
}, - {
- "id": 158,
- "description": "Religiöse Waren"
}, - {
- "id": 159,
- "description": "Hörgeräte"
}, - {
- "id": 160,
- "description": "Sanitaetshaus"
}, - {
- "id": 161,
- "description": "Rehatechnik"
}, - {
- "id": 162,
- "description": "Parfuemerie"
}, - {
- "id": 163,
- "description": "Kosmetik"
}, - {
- "id": 164,
- "description": "Blumen"
}, - {
- "id": 165,
- "description": "Tabak"
}, - {
- "id": 166,
- "description": "Kiosk"
}, - {
- "id": 167,
- "description": "Tierbedarf"
}, - {
- "id": 168,
- "description": "Einzelhandel"
}, - {
- "id": 169,
- "description": "Facheinzelhandel"
}, - {
- "id": 170,
- "description": "Weinhandel"
}, - {
- "id": 171,
- "description": "Finanzdienstleistungen"
}, - {
- "id": 172,
- "description": "Wertpapiermarkler und -händler"
}, - {
- "id": 173,
- "description": "Versicherungen"
}, - {
- "id": 174,
- "description": "Versicherungsvermittlung"
}, - {
- "id": 175,
- "description": "Immobilien"
}, - {
- "id": 176,
- "description": "Leihhäuser"
}, - {
- "id": 177,
- "description": "Hotel"
}, - {
- "id": 178,
- "description": "Hotel & Restaurant"
}, - {
- "id": 179,
- "description": "Jugendherrberge"
}, - {
- "id": 180,
- "description": "Pension"
}, - {
- "id": 181,
- "description": "Campingplatz"
}, - {
- "id": 182,
- "description": "Reinigung"
}, - {
- "id": 183,
- "description": "Gebäudereinigung"
}, - {
- "id": 184,
- "description": "Fotostudio"
}, - {
- "id": 185,
- "description": "Friseur"
}, - {
- "id": 186,
- "description": "Schuhmacher"
}, - {
- "id": 187,
- "description": "Bestattungsinstitut"
}, - {
- "id": 188,
- "description": "Partnervermittlung"
}, - {
- "id": 189,
- "description": "Steuerberater"
}, - {
- "id": 190,
- "description": "med. Massage"
}, - {
- "id": 191,
- "description": "Schoenheitspflege"
}, - {
- "id": 192,
- "description": "Nagelstudio"
}, - {
- "id": 193,
- "description": "Wellness"
}, - {
- "id": 194,
- "description": "Sonnenstudio"
}, - {
- "id": 195,
- "description": "Dienstleistung"
}, - {
- "id": 196,
- "description": "Entsorgung"
}, - {
- "id": 197,
- "description": "Werbung"
}, - {
- "id": 198,
- "description": "Gewerbliche Photographie, Kunst und Graf"
}, - {
- "id": 199,
- "description": "Copyshop"
}, - {
- "id": 200,
- "description": "Kopierservice"
}, - {
- "id": 201,
- "description": "Schreibbuero"
}, - {
- "id": 202,
- "description": "Personalagentur"
}, - {
- "id": 203,
- "description": "Rettungsdienst"
}, - {
- "id": 204,
- "description": "Kassensysteme"
}, - {
- "id": 205,
- "description": "Unternehmensberatung"
}, - {
- "id": 206,
- "description": "Detektei"
}, - {
- "id": 207,
- "description": "Fotolabor"
}, - {
- "id": 208,
- "description": "Spezialdienstleistl."
}, - {
- "id": 209,
- "description": "Schlüsseldienst"
}, - {
- "id": 210,
- "description": "Raumausstatter"
}, - {
- "id": 211,
- "description": "Fitness"
}, - {
- "id": 212,
- "description": "Sicherheitstechnik"
}, - {
- "id": 213,
- "description": "Schornsteinfeger"
}, - {
- "id": 214,
- "description": "Kanalreinigung"
}, - {
- "id": 215,
- "description": "Autovermietung"
}, - {
- "id": 216,
- "description": "Mietwagen"
}, - {
- "id": 217,
- "description": "LKW- und Anhänger-Vermietung"
}, - {
- "id": 218,
- "description": "Parkhaus"
}, - {
- "id": 219,
- "description": "Reifenhandel"
}, - {
- "id": 220,
- "description": "Autolackiererei"
}, - {
- "id": 221,
- "description": "Kfz.Werkstatt"
}, - {
- "id": 222,
- "description": "Autowaschanlage"
}, - {
- "id": 223,
- "description": "Abschleppdienst"
}, - {
- "id": 224,
- "description": "Electronik"
}, - {
- "id": 225,
- "description": "Elektrofachgeschaeft"
}, - {
- "id": 226,
- "description": "Uhren- und Schmuckreparaturen"
}, - {
- "id": 227,
- "description": "Möbel- Polstermöbelreparaturen und Aufbe"
}, - {
- "id": 228,
- "description": "Reparaturdienst"
}, - {
- "id": 229,
- "description": "Film- u.Videoproduktion"
}, - {
- "id": 230,
- "description": "Kino"
}, - {
- "id": 231,
- "description": "Videoverleih"
}, - {
- "id": 232,
- "description": "Tanzstudio"
}, - {
- "id": 233,
- "description": "Ticketshop"
}, - {
- "id": 234,
- "description": "Konzertkasse"
}, - {
- "id": 235,
- "description": "Band/Orchester"
}, - {
- "id": 236,
- "description": "Billard+Pool Establ."
}, - {
- "id": 237,
- "description": "Kegel/Bowlingbahn"
}, - {
- "id": 238,
- "description": "Sportclub"
}, - {
- "id": 239,
- "description": "Touristik"
}, - {
- "id": 240,
- "description": "Golfplatz"
}, - {
- "id": 241,
- "description": "Video Games"
}, - {
- "id": 242,
- "description": "Lotto"
}, - {
- "id": 243,
- "description": "Spielhalle"
}, - {
- "id": 244,
- "description": "Freizeitpart"
}, - {
- "id": 245,
- "description": "Hobbybedarf"
}, - {
- "id": 246,
- "description": "Aquarien, Seeacquarien und Delphinariums"
}, - {
- "id": 247,
- "description": "Freizeiteinrichtung"
}, - {
- "id": 248,
- "description": "Museum"
}, - {
- "id": 249,
- "description": "Theater"
}, - {
- "id": 250,
- "description": "Arzt"
}, - {
- "id": 251,
- "description": "Zahnarzt"
}, - {
- "id": 252,
- "description": "Osteopathie"
}, - {
- "id": 253,
- "description": "Physiotherapie"
}, - {
- "id": 254,
- "description": "Optiker"
}, - {
- "id": 255,
- "description": "Sonnenbrillen + Zubehör"
}, - {
- "id": 256,
- "description": "med. Fusspflege"
}, - {
- "id": 257,
- "description": "Privatklinik"
}, - {
- "id": 258,
- "description": "Krankenhaus"
}, - {
- "id": 259,
- "description": "Gesundheit"
}, - {
- "id": 260,
- "description": "Kanzlei"
}, - {
- "id": 261,
- "description": "Rechtsanwalt"
}, - {
- "id": 262,
- "description": "Notar"
}, - {
- "id": 263,
- "description": "Weiterbildungsprogr."
}, - {
- "id": 264,
- "description": "Geschäfts- und Sekretariats-/Büroschule"
}, - {
- "id": 265,
- "description": "Schule"
}, - {
- "id": 266,
- "description": "Fahrschule"
}, - {
- "id": 267,
- "description": "Kinderpflege"
}, - {
- "id": 268,
- "description": "Spendenabteilung"
}, - {
- "id": 269,
- "description": "Verein"
}, - {
- "id": 270,
- "description": "Automobilclub"
}, - {
- "id": 271,
- "description": "Ingenieurbüro"
}, - {
- "id": 272,
- "description": "Möbel"
}, - {
- "id": 273,
- "description": "Veranstaltungsservice"
}, - {
- "id": 274,
- "description": "Öffentlicher Dienst"
}, - {
- "id": 275,
- "description": "Einrichtung"
}, - {
- "id": 277,
- "description": "Bürotechnik"
}, - {
- "id": 278,
- "description": "Mineralöl"
}, - {
- "id": 279,
- "description": "Tierheim"
}, - {
- "id": 280,
- "description": "Catering"
}, - {
- "id": 281,
- "description": "Tierbestattungen"
}, - {
- "id": 282,
- "description": "Testnutzer (für Testzwecke)"
}, - {
- "id": 283,
- "description": "Baustoffhandel"
}, - {
- "id": 284,
- "description": "Hochschule"
}, - {
- "id": 285,
- "description": "Berufsschule"
}, - {
- "id": 286,
- "description": "Lohnsteuerhilfe"
}, - {
- "id": 287,
- "description": "Medizintechnik"
}
]
Manages the contracts of a merchant, including the specific options and conditions. A merchant can have one contract, but also multiple contracts for different purposes. There are separate views on the contracts for payment (s. Payment Contracts) and e-goods (s. Prepaid Contracts).
Returns the General Contracts matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching General Contracts
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 48,
- "data": [
- {
- "object": "general.contracts",
- "id": "GCR_TGHA8UNA0QMX5RX95MVUIBQ1STPVQV",
- "id_old": 1234567,
- "approved": true,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_J0P3PURCVVYS5I8GGJY6P2PI0K7LO4"
}
}, - {
- "object": "general.contracts",
- "id": "GCR_LG68DKRBHVBYTLVWGQM6T9YMYW2XFU",
- "id_old": 1357999,
- "approved": false,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_PHR45JEIVKBNT0F8RU8C8K2KX4CMIF",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_J0P3PURCVVYS5I8GGJY6P2PI0K7LO4",
- "type": 21
}
}, - "pay_in_advance_account": {
- "iban": "DE02120300000000202051",
- "bic": "WELADEDDXXX",
- "owner": "secupay AG",
- "bankname": "Landesbank Hessen-Thüringen Girozentrale NL. Düsseldorf"
}, - "parent": {
- "object": "general.contracts",
- "id": "GCR_S4Z8VSDBPU81I0MWJCRGGGB9J81ND0"
}
}
]
}
Returns the specified General Contract.
generalContractId required | string General Contract ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
General Contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "general.contracts",
- "id": "GCR_LG68DKRBHVBYTLVWGQM6T9YMYW2XFU",
- "id_old": 1357999,
- "approved": false,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_PHR45JEIVKBNT0F8RU8C8K2KX4CMIF",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_J0P3PURCVVYS5I8GGJY6P2PI0K7LO4",
- "type": 21
}
}, - "pay_in_advance_account": {
- "iban": "DE02120300000000202051",
- "bic": "WELADEDDXXX",
- "owner": "secupay AG",
- "bankname": "Landesbank Hessen-Thüringen Girozentrale NL. Düsseldorf"
}, - "paypal_configuration": {
- "sandbox": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}, - "live": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}, - "easycredit_configuration": {
- "sandbox": {
- "client_id": "9.de.9999.9"
}
}, - "checkout_configuration": {
- "notifications": {
- "merchant_order_mail": true,
- "customer_order_mail": true
}
}, - "payment_link_options": {
}
}
Updates the specified General Contract with the given data.
generalContractId required | string General Contract ID |
Contract details
checkout_configuration | object (CheckoutConfiguration) General checkout settings |
Updated General Contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "checkout_configuration": {
- "notifications": {
- "merchant_order_mail": true,
- "customer_order_mail": true
}
}
}
{- "object": "general.contracts",
- "id": "GCR_LG68DKRBHVBYTLVWGQM6T9YMYW2XFU",
- "id_old": 1357999,
- "approved": false,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_PHR45JEIVKBNT0F8RU8C8K2KX4CMIF",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_J0P3PURCVVYS5I8GGJY6P2PI0K7LO4",
- "type": 21
}
}, - "pay_in_advance_account": {
- "iban": "DE02120300000000202051",
- "bic": "WELADEDDXXX",
- "owner": "secupay AG",
- "bankname": "Landesbank Hessen-Thüringen Girozentrale NL. Düsseldorf"
}, - "paypal_configuration": {
- "sandbox": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}, - "live": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}, - "easycredit_configuration": {
- "sandbox": {
- "client_id": "9.de.9999.9"
}
}, - "checkout_configuration": {
- "notifications": {
- "merchant_order_mail": true,
- "customer_order_mail": true
}
}, - "payment_link_options": {
}
}
Updates the specified General Contract with the given data.
generalContractId required | string General Contract ID |
Contract details
checkout_configuration | object (CheckoutConfiguration) General checkout settings |
Updated General Contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "checkout_configuration": {
- "notifications": {
- "merchant_order_mail": true,
- "customer_order_mail": true
}
}
}
{- "object": "general.contracts",
- "id": "GCR_LG68DKRBHVBYTLVWGQM6T9YMYW2XFU",
- "id_old": 1357999,
- "approved": false,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_PHR45JEIVKBNT0F8RU8C8K2KX4CMIF",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_J0P3PURCVVYS5I8GGJY6P2PI0K7LO4",
- "type": 21
}
}, - "pay_in_advance_account": {
- "iban": "DE02120300000000202051",
- "bic": "WELADEDDXXX",
- "owner": "secupay AG",
- "bankname": "Landesbank Hessen-Thüringen Girozentrale NL. Düsseldorf"
}, - "paypal_configuration": {
- "sandbox": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}, - "live": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}, - "easycredit_configuration": {
- "sandbox": {
- "client_id": "9.de.9999.9"
}
}, - "checkout_configuration": {
- "notifications": {
- "merchant_order_mail": true,
- "customer_order_mail": true
}
}, - "payment_link_options": {
}
}
Returns the balance eligible for payouts resulting from bank transfers for each currency of the specified General Contract.
generalContractId required | string <id> (ObjectId) Example: OBJ_MNTPQ9IFD3V482Y6VMHJXERBYS4J1G General Contract ID |
Balance for each currency
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "id": "GCR_LG68DKRBHVBYTLVWGQM6T9YMYW2XFU",
- "balances": [
- {
- "EUR": 2345600
}
]
}
Returns the payment methods, available for the specified General Contract and Smart Transactions. It considers currency and demo mode from the response header, and other data from the Smart Transaction.
generalContractId required | string General Contract ID |
smartTransactionId required | string Smart Transaction ID |
Request details
currency required | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
is_demo required | boolean Demo mode. Such transactions are not actually processed. |
apiv2_products | boolean Nullable If TRUE, the response will use the flex.API/APIv2 product names, and the other parameters will be ignored. |
Payment methods for particular Smart Transactions
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "is_demo": true,
- "currency": "EUR"
}
[- "Creditcard",
- "Debit",
- "easyCredit",
- "eps",
- "Invoice",
- "Paypal",
- "Prepay",
- "Sofort",
- "Applepay",
- "Googlepay"
]
Returns the configuration for third parties, e. g. PayPal.
generalContractId required | string General Contract ID |
Third party configuration
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "paypal": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}
}
Sets the configuration for third parties, e. g. PayPal.
generalContractId required | string General Contract ID |
Third party configuration
paypal | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
easycredit | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
saferpay | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
Third party configuration
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "paypal": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}
}
{- "paypal": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}
}
Updates the configuration for third parties, e. g. PayPal.
generalContractId required | string General Contract ID |
Third party configuration
paypal | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
easycredit | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
saferpay | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
Third party configuration
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "paypal": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}
}
{- "paypal": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}
}
Updates the configuration for third parties, e. g. PayPal, partially.
generalContractId required | string General Contract ID |
Third party configuration
paypal | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
easycredit | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
saferpay | object (ThirdPartyEnvironmentDTO) Nullable Third-Party environment settings |
Third party configuration
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "paypal": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string",
- "client_secret": "string"
}, - "sandbox": {
- "client_id": "string",
- "client_secret": "string"
}
}
}
{- "paypal": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}
}
Deletes one or all third party configurations for the specified General Contract.
generalContractId required | string General Contract ID |
thirdPartyName required | string Nullable Default: null Example: paypal Third party name:
|
Third party configuration
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "paypal": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "easycredit": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}, - "saferpay": {
- "live": {
- "client_id": "string"
}, - "sandbox": {
- "client_id": "string"
}
}
}
Returns the payment methods, available for the specified General Contract.
generalContractId required | string General Contract ID |
Request details
currency required | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
is_demo required | boolean Demo mode. Such transactions are not actually processed. |
apiv2_products | boolean Nullable If TRUE, the response will use the flex.API/APIv2 product names, and the other parameters will be ignored. |
Payment methods for contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "is_demo": true,
- "currency": "EUR"
}
{- "$ref": "#/components/examples/GeneralContractsGetAvailablePaymentMethodsResponse/value"
}
Revokes the accrual flags for all transactions of the specified General Contract. Thus all these transactions are executed then.
generalContractId required | string General Contract ID |
Request accepted
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "status": "error",
- "error": "ProductUnauthorizedException",
- "error_details": "Invalid token",
- "error_user": "ungültiger Token",
- "code": 0,
- "supportId": "s4l2y7oyr10p7wjtg8o6gnq2esly6r3v"
}
Terminates the specified General Contract.
generalContractId required | string General Contract ID |
Success
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "result": true
}
Saves the configuration for Payment Link, the payment page, for the specified General Contract.
generalContractId required | string General Contract ID |
Payment Link configuration
background | object (BackgroundImageOption) BackgroundImageOption |
Updated General Contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{
}
{- "object": "general.contracts",
- "id": "GCR_LG68DKRBHVBYTLVWGQM6T9YMYW2XFU",
- "id_old": 1357999,
- "approved": false,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_PHR45JEIVKBNT0F8RU8C8K2KX4CMIF",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_J0P3PURCVVYS5I8GGJY6P2PI0K7LO4",
- "type": 21
}
}, - "pay_in_advance_account": {
- "iban": "DE02120300000000202051",
- "bic": "WELADEDDXXX",
- "owner": "secupay AG",
- "bankname": "Landesbank Hessen-Thüringen Girozentrale NL. Düsseldorf"
}, - "paypal_configuration": {
- "sandbox": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}, - "live": {
- "client_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}, - "easycredit_configuration": {
- "sandbox": {
- "client_id": "9.de.9999.9"
}
}, - "checkout_configuration": {
- "notifications": {
- "merchant_order_mail": true,
- "customer_order_mail": true
}
}, - "payment_link_options": {
}
}
Returns the options for the payment iframe for the given contract. The payment iframe was based on the obsolete Flex.API.
generalContractId required | string General Contract ID |
Iframe options
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "payment_hint_title": null,
- "project_title": null,
- "project_logo": null,
- "submit_button_title": null,
- "primary_colour": null,
- "language": "de_DE",
- "basket_title": null,
- "is_basket_shown": true,
- "language_formality": "formal",
- "payment_config": {
- "Googlepay": {
- "api_version": 2,
- "api_version_minor": 0,
- "type": "CARD",
- "allowed_auth_methods": [
- "CRYPTOGRAM_3DS"
], - "allowed_card_networks": [
- "MASTERCARD",
- "VISA"
], - "gateway": "credorax",
- "gateway_merchant_id": "SECUP978",
- "merchant_id": "8S1DOIRYLUXU3M11",
- "merchant_name": "Musterhändler GmbH"
}, - "Applepay": {
- "label": "Test",
- "supported_networks": [
- "masterCard",
- "visa",
- "maestro",
- "vPay"
], - "merchant_capabilities": [
- "supports3DS"
]
}
}
}
Returns the payment methods, available for the given contract.
generalContractId required | string General Contract ID |
Available currencies
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
[- "EUR",
- "CHF"
]
Changes the bank account, that is used for payouts.
generalContractId required | string General Contract ID |
Bank details
iban | string International Bank Account Number (IBAN) |
bic | string Bank Identifier Code (BIC) |
owner | string Account owner name (personal name or company name) |
bankname | string Nullable Bank name |
verification_document | string Nullable Default: null Document Uploads ID of verification document |
Whether successful or not
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "owner": "Max Mustermann",
- "bankname": "Deutsche Kreditbank Berlin",
- "verification_document": "DUP_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH"
}
{- "result": true
}
The stores of a merchant. Smart ZVT devices are assigned to stores. And Click & Collect arrangements are for specific stores.
Returns the General Stores matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching General Stores
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 1,
- "data": [
- {
- "object": "general.stores",
- "id": "STO_G6ZOIFP46V02KUJBPDTKK008VIK4QH",
- "id_old": 1046176,
- "store_name": null,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_KLMDFHSWEYQ938WPCJHGF3D74XUMNI"
}, - "acceptance_point": false,
- "name": "Musterstadt Muster-Center",
- "name_raw": "Musterstadt Muster-Center",
- "facebook_id": "",
- "has_beacon": false,
- "open_hours": [
- {
- "open": {
- "day": 1,
- "time": "0800"
}, - "close": {
- "day": 1,
- "time": "2300"
}
}, - {
- "open": {
- "day": 2,
- "time": "0800"
}, - "close": {
- "day": 2,
- "time": "2300"
}
}, - {
- "open": {
- "day": 3,
- "time": "0800"
}, - "close": {
- "day": 3,
- "time": "2300"
}
}, - {
- "open": {
- "day": 4,
- "time": "0800"
}, - "close": {
- "day": 4,
- "time": "2300"
}
}, - {
- "open": {
- "day": 5,
- "time": "0800"
}, - "close": {
- "day": 5,
- "time": "2300"
}
}, - {
- "open": {
- "day": 6,
- "time": "0800"
}, - "close": {
- "day": 6,
- "time": "2300"
}
}
], - "open_now": true,
- "open_time": 321,
- "phone_number_formatted": "",
}
]
}
Creates a new General Store from the given data.
Store details
name | string Name |
merchant | string General Merchant ID |
address | object (Address) Postal address |
facebook_id | string New facebook ID |
phone | string New phone number |
url_website | string New URL to general store website |
photo_main | string New main photo |
photo | Array of strings New photos |
open_hours | Array of objects (OpenHours) Opening hours per weekday |
Newly created General Store
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "name": "Musterstadt Muster-Centerg",
- "merchant": "MRC_KLMDFHSWEYQ938WPCJHGF3D74XUMNI",
- "address": {
- "type": null,
- "street": "Musterstr.",
- "street_number": "12 a",
- "city": "Musterstadt",
- "postal_code": "09999",
- "country": "DE",
- "additional_address_data": null
}, - "phone": "+49 555 5555555"
}
{- "object": "general.stores",
- "id": "STO_G6ZOIFP46V02KUJBPDTKK008VIK4QH",
- "id_old": 1046176,
- "store_name": null,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_KLMDFHSWEYQ938WPCJHGF3D74XUMNI"
}, - "acceptance_point": false,
- "name": "Musterstadt Muster-Center",
- "name_raw": "Musterstadt Muster-Center",
- "facebook_id": "",
- "has_beacon": false,
- "open_hours": [
- {
- "open": {
- "day": 1,
- "time": "0800"
}, - "close": {
- "day": 1,
- "time": "2300"
}
}, - {
- "open": {
- "day": 2,
- "time": "0800"
}, - "close": {
- "day": 2,
- "time": "2300"
}
}, - {
- "open": {
- "day": 3,
- "time": "0800"
}, - "close": {
- "day": 3,
- "time": "2300"
}
}, - {
- "open": {
- "day": 4,
- "time": "0800"
}, - "close": {
- "day": 4,
- "time": "2300"
}
}, - {
- "open": {
- "day": 5,
- "time": "0800"
}, - "close": {
- "day": 5,
- "time": "2300"
}
}, - {
- "open": {
- "day": 6,
- "time": "0800"
}, - "close": {
- "day": 6,
- "time": "2300"
}
}
], - "open_now": true,
- "open_time": 321,
- "phone_number_formatted": "",
}
Returns the specified General Store.
generalStoreId required | string General Store ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
General Store
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "general.stores",
- "id": "STO_G6ZOIFP46V02KUJBPDTKK008VIK4QH",
- "id_old": 1046176,
- "store_name": null,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_KLMDFHSWEYQ938WPCJHGF3D74XUMNI"
}, - "acceptance_point": false,
- "name": "Musterstadt Muster-Center",
- "name_raw": "Musterstadt Muster-Center",
- "facebook_id": "",
- "has_beacon": false,
- "open_hours": [
- {
- "open": {
- "day": 1,
- "time": "0800"
}, - "close": {
- "day": 1,
- "time": "2300"
}
}, - {
- "open": {
- "day": 2,
- "time": "0800"
}, - "close": {
- "day": 2,
- "time": "2300"
}
}, - {
- "open": {
- "day": 3,
- "time": "0800"
}, - "close": {
- "day": 3,
- "time": "2300"
}
}, - {
- "open": {
- "day": 4,
- "time": "0800"
}, - "close": {
- "day": 4,
- "time": "2300"
}
}, - {
- "open": {
- "day": 5,
- "time": "0800"
}, - "close": {
- "day": 5,
- "time": "2300"
}
}, - {
- "open": {
- "day": 6,
- "time": "0800"
}, - "close": {
- "day": 6,
- "time": "2300"
}
}
], - "open_now": true,
- "open_time": 321,
- "phone_number_formatted": "",
}
Updates the specified General Store with the given data.
generalStoreId required | string General Store ID |
Store details
name | string Name |
merchant | string General Merchant ID |
address | object (Address) Postal address |
facebook_id | string New facebook ID |
phone | string New phone number |
url_website | string New URL to general store website |
photo_main | string New main photo |
photo | Array of strings New photos |
open_hours | Array of objects (OpenHours) Opening hours per weekday |
Updated General Store
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "name": "Musterstadt Muster-Center"
}
{- "object": "general.stores",
- "id": "STO_G6ZOIFP46V02KUJBPDTKK008VIK4QH",
- "id_old": 1046176,
- "store_name": null,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_KLMDFHSWEYQ938WPCJHGF3D74XUMNI"
}, - "acceptance_point": false,
- "name": "Musterstadt Muster-Center",
- "name_raw": "Musterstadt Muster-Center",
- "facebook_id": "",
- "has_beacon": false,
- "open_hours": [
- {
- "open": {
- "day": 1,
- "time": "0800"
}, - "close": {
- "day": 1,
- "time": "2300"
}
}, - {
- "open": {
- "day": 2,
- "time": "0800"
}, - "close": {
- "day": 2,
- "time": "2300"
}
}, - {
- "open": {
- "day": 3,
- "time": "0800"
}, - "close": {
- "day": 3,
- "time": "2300"
}
}, - {
- "open": {
- "day": 4,
- "time": "0800"
}, - "close": {
- "day": 4,
- "time": "2300"
}
}, - {
- "open": {
- "day": 5,
- "time": "0800"
}, - "close": {
- "day": 5,
- "time": "2300"
}
}, - {
- "open": {
- "day": 6,
- "time": "0800"
}, - "close": {
- "day": 6,
- "time": "2300"
}
}
], - "open_now": true,
- "open_time": 321,
- "phone_number_formatted": "",
}
Makes the specified General Store the default store of its General Merchant.
generalStoreId required | string General store id |
Short reason note
reason | string Reason |
Whether it was successful
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "reason": "string"
}
{- "result": true
}
In difference to a Payment Transaction, a Smart Transaction covers a wider range of use cases. It is also more connected to the business case than to the many details of the payment process. And it is the basis for Smart Checkout and Payment Link.
Smart Transactions can be used for e-commerce and cross channel scenarios, to integrate customer loyalty programmes at the POS, etc., etc. It is not predetermined to a specific payment method, and will manage the Payment Transaction for you.
Creates a new Smart Transaction from the given data.
Transaction details
merchant | string Merchant |
provider_contract | object (ProductInstanceUID) Object type and ID |
transactionRef | string Purpose for bank statement; would usually contain shop name and order number or date |
merchantRef | string Merchant reference for secuOffice; usually shop order number or ID |
basket | object (SmartTransactionsBasket) Basket items, several sub-baskets or subscription details |
basket_info | object (SmartTransactionsBasketInfo) Basket information |
idents | Array of objects (SmartTransactionsIdent) secucard customer card or voucher, or request to create it |
tax_amount | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
tax_rate | integer (TaxRate) Tax rate in percent |
market | string Market |
cashier | string Cashier |
product | string Product |
device_source | object (ProductInstanceUID) Object type and ID |
trans_id | integer Transaction ID (TA code) |
contract | object (ProductInstanceID) Object ID |
last_visited_page | string Last visited page |
customer | object (SmartTransactionPaymentCustomerDTO) Customer details |
shipping_address | object (SmartTransactionPaymentCustomerDTO) Customer details |
container | object (SmartTransactionPaymentContainerDTO) Payment instrument |
checkin | object (SmartTransactionsCheckin) Check-in |
is_demo | boolean Whether the transaction is in demo mode (payment not executed) |
intent | string Intent:
|
checkout_links | object (SmartTransactionsCheckoutLinks) Checkout URLs |
delivery_options | object (OneOfSmartTransactionsDeliveryOptionsModel) Delivery options, either for shipping or collection |
communications | object (SmartTransactionsCommunication) Send an email with execution of the Smart Transaction; loyalty card only |
application_context | object (SmartTransactionsApplicationContext) Controls the integration between Smart Checkout and the shop. |
payment_context | object (PaymentContext) Controls some payment details |
Newly created Smart Transaction
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "is_demo": true,
- "contract": {
- "id": "GCR_CEIW6JUO4U27162RGU7SA1ROX70KAU"
}, - "customer": {
- "contact": {
- "forename": "Max",
- "surname": "Mustermann",
- "email": "max@example.net"
}
}, - "basket_info": {
- "sum": 1995,
- "currency": "EUR"
}, - "application_context": {
- "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}
}
{- "object": "smart.transactions",
- "id": "STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_CEIW6JUO4U27162RGU7SA1ROX70KAU"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_W0MXYGDW42P6A42QM84N0P9YG0Y7A3",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "max@example.net"
}
}, - "transactions": [ ],
- "created": "2023-08-02T11:24:05+02:00",
- "status": "created",
- "intent": "sale",
- "basket_info": {
- "sum": 1995,
- "currency": "EUR"
}, - "is_demo": true,
- "application_context": {
- "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}, - "payment_context": {
- "auto_capture": false,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
Returns the Smart Transactions matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Smart Transactions
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 15893,
- "data": [
- {
- "object": "smart.transactions",
- "id": "STX_A1BMFMUJNE7M699Z4TM6N20VVCP0T7",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_CEIW6JUO4U27162RGU7SA1ROX70KAU"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_8MXTUPQJLBS13IAW4R2FXXZ173KQGH",
- "contact": {
- "name": "Martina Mustermann",
- "forename": "Martina",
- "surname": "Mustermann",
- "dob": "1980-01-01T00:00:00+00:00",
- "email": "martina@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [ ],
- "created": "2023-08-03T12:51:52+02:00",
- "status": "created",
- "transactionRef": "Bestellnr. 20000346 bei Example.com",
- "merchantRef": "20000346",
- "intent": "sale",
- "basket": {
- "products": [
- {
- "id": 1,
- "item_type": "article",
- "desc": "Kaffeemaschine",
- "quantity": 2,
- "priceOne": 3995,
- "tax": 19
}, - {
- "id": 4,
- "item_type": "shipping",
- "desc": "Standardversand",
- "quantity": 1,
- "priceOne": 495,
- "tax": 19
}
], - "type": "default"
}, - "basket_info": {
- "sum": 4490,
- "currency": "EUR"
}, - "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de",
- "shop_details": {
- "shop_system": "Mustershop",
- "shop_system_version": "3.2.1",
- "shop_domain": "beispiel.de",
- "plugin_vendor": "Musterentwickler GbR",
- "plugin_version": "4.5.6",
- "user_agent": "PostmanRuntime/7.32.3"
}
}, - "payment_context": {
- "auto_capture": true,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}, - {
- "object": "smart.transactions",
- "id": "STX_26VUEEXK62P6BGR48A2UV78BGRDAAK",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_CEIW6JUO4U27162RGU7SA1ROX70KAU"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_WAD6FUDZH2P6BGR48A2UV78BGRDAAJ",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "dob": "1980-01-01T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [ ],
- "created": "2023-08-03T12:51:52+02:00",
- "status": "created",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket": {
- "products": [
- {
- "id": 1,
- "item_type": "article",
- "desc": "Kugelschreiber Modern Alu",
- "quantity": 2,
- "priceOne": 1595,
- "tax": 19
}, - {
- "id": 2,
- "item_type": "article",
- "desc": "Stiftetasche Duo",
- "quantity": 1,
- "priceOne": 1795,
- "tax": 19
}, - {
- "id": 3,
- "item_type": "shipping",
- "desc": "Standardversand",
- "quantity": 1,
- "priceOne": 495,
- "tax": 19
}
], - "type": "default"
}, - "basket_info": {
- "sum": 5480,
- "currency": "EUR"
}, - "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "en",
- "shop_details": {
- "shop_system": "Mustershop",
- "shop_system_version": "3.2.1",
- "shop_domain": "beispiel.de",
- "plugin_vendor": "Musterentwickler GbR",
- "plugin_version": "4.5.6",
- "user_agent": "PostmanRuntime/7.32.3"
}
}, - "payment_context": {
- "auto_capture": true,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
]
}
Returns the specified Smart Transaction.
smartTransactionId required | string Example: STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4 Smart Transaction ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.transactions",
- "id": "STX_A1BMFMUJNE7M699Z4TM6N20VVCP0T7",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_CEIW6JUO4U27162RGU7SA1ROX70KAU"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_8MXTUPQJLBS13IAW4R2FXXZ173KQGH",
- "contact": {
- "name": "Martina Mustermann",
- "forename": "Martina",
- "surname": "Mustermann",
- "dob": "1980-01-01T00:00:00+00:00",
- "email": "martina@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [ ],
- "created": "2023-08-03T12:51:52+02:00",
- "status": "created",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket": {
- "products": [
- {
- "id": 1,
- "item_type": "article",
- "desc": "Kaffeemaschine",
- "quantity": 2,
- "priceOne": 3995,
- "tax": 19
}, - {
- "id": 4,
- "item_type": "shipping",
- "desc": "Standardversand",
- "quantity": 1,
- "priceOne": 495,
- "tax": 19
}
], - "type": "default"
}, - "basket_info": {
- "sum": 4490,
- "currency": "EUR"
}, - "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "en",
- "shop_details": {
- "shop_system": "Mustershop",
- "shop_system_version": "3.2.1",
- "shop_domain": "beispiel.de",
- "plugin_vendor": "Musterentwickler GbR",
- "plugin_version": "4.5.6",
- "user_agent": "PostmanRuntime/7.32.3"
}
}, - "payment_context": {
- "auto_capture": true,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
Updates the specified Smart Transaction with the given data. It can only be updated before the payment is executed with POST /Smart/Transactions/{id}/start[/{method}]
, or with POST /Smart/Transactions/{id}/prepare/{method}
in combination with auto_capture
.
You must always pass basket
and basket_info
. Otherwise basket
is removed, and basket info is set to the defaults.
Some data can not be changed after creation, f. e. application_context
.
smartTransactionId required | string Example: STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4 Smart Transaction ID |
Transaction details
merchant | string Merchant |
provider_contract | object (ProductInstanceUID) Object type and ID |
transactionRef | string Purpose for bank statement; would usually contain shop name and order number or date |
merchantRef | string Merchant reference for secuOffice; usually shop order number or ID |
basket | object (SmartTransactionsBasket) Basket items, several sub-baskets or subscription details |
basket_info | object (SmartTransactionsBasketInfo) Basket information |
idents | Array of objects (SmartTransactionsIdent) secucard customer card or voucher, or request to create it |
tax_amount | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
tax_rate | integer (TaxRate) Tax rate in percent |
market | string Market |
cashier | string Cashier |
product | string Product |
device_source | object (ProductInstanceUID) Object type and ID |
trans_id | integer Transaction ID (TA code) |
contract | object (ProductInstanceID) Object ID |
last_visited_page | string Last visited page |
customer | object (SmartTransactionPaymentCustomerDTO) Customer details |
shipping_address | object (SmartTransactionPaymentCustomerDTO) Customer details |
container | object (SmartTransactionPaymentContainerDTO) Payment instrument |
checkin | object (SmartTransactionsCheckin) Check-in |
is_demo | boolean Whether the transaction is in demo mode (payment not executed) |
intent | string Intent:
|
checkout_links | object (SmartTransactionsCheckoutLinks) Checkout URLs |
delivery_options | object (OneOfSmartTransactionsDeliveryOptionsModel) Delivery options, either for shipping or collection |
communications | object (SmartTransactionsCommunication) Send an email with execution of the Smart Transaction; loyalty card only |
application_context | object (SmartTransactionsApplicationContext) Controls the integration between Smart Checkout and the shop. |
payment_context | object (PaymentContext) Controls some payment details |
Updated Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "is_demo": true,
- "contract": {
- "id": "GCR_CEIW6JUO4U27162RGU7SA1ROX70KAU"
}, - "customer": {
- "contact": {
- "forename": "Max",
- "surname": "Mustermann",
- "email": "max@example.net"
}
}, - "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "basket_info": {
- "sum": 1995,
- "currency": "EUR"
}
}
{- "object": "smart.transactions",
- "id": "STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_CEIW6JUO4U27162RGU7SA1ROX70KAU"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_28SGP52RG2P6AET73P2A3WSGG5HDA3",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "max@example.net"
}
}, - "transactions": [ ],
- "created": "2023-08-02T11:24:05+02:00",
- "updated": "2023-08-02T17:33:34+02:00",
- "status": "created",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket_info": {
- "sum": 1995,
- "currency": "EUR"
}, - "is_demo": true,
- "application_context": {
- "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}, - "payment_context": {
- "auto_capture": false,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
Checks the balance of the secucard Merchant Card in ident
. If there is cash or bonus balance that can be applied, it adds bonus items to the basket and sets missing_sum
inside basket_info
.
Note: In contrast to other operations it doesn't return the full object.
In order to pay, you need to call one of the endpoints:
/start/loyalty
if there is no missing sum;/start/cash
if the remainder is paid at the cash register (ECR) without our terminals;/start/cashless
if the remainder is paid at the ECR with one of our terminals;/prepare/debit
and /start
if the remainder is paid with SEPA direct debit;/prepare/creditcard
and /start
if the remainder is paid with credit card.smartTransactionId required | string Example: STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4 Smart Transaction ID |
Missing sum and bonus items
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "missing_sum": 576,
- "bonus_products": [
- {
- "id": 4,
- "articleNumber": "111000007",
- "quantity": 1,
- "priceOne": -15,
- "tax": 7,
- "desc": "Bonus 7% USt"
}, - {
- "id": 5,
- "articleNumber": "111000019",
- "quantity": 1,
- "priceOne": -5,
- "tax": 19,
- "desc": "Bonus 19% USt"
}
]
}
Create the Payment Transaction and links it to the Smart Transaction. If required, a scoring is performed. When auto_capture
is set on true
it will also start the Smart Transaction and execute the payment.
You can pass the payment data or the ID of an existing Payment Container. Likewise, you can also pass the customer details or the ID of an existing Payment Customer. If not passed, it is expected these details have been set before.
smartTransactionId required | string Example: STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4 Smart Transaction ID |
paymentMethod required | string Example: creditcard Payment method:
|
Optional customer and/or payment details
customer | object (SmartTransactionPaymentCustomerDTO) Customer details |
container | object (SmartTransactionPaymentContainerDTO) Payment instrument |
callback_urls | object (SmartTransactionsPrepareCallbackUrls) Return URLs for external payment authorization. Note: Please don't mix them up with the return URLs for Smart Checkout. These here are intended for custom checkout implementations to catch the user when he returns from 3-D Secure, PayPal, Sofort, and the like. |
dynamic_descriptor | object (SmartTransactionsPrepareDynamicDescriptor) Dynamic Descriptor to allow the cardholder to recognize the business name and city on their card or bank statement. |
string Email address |
Updated Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Payment method not available, approval failed, or auto-capture failed
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "container": {
- "type": "credit_card",
- "private": {
- "owner": "Max Mustermann",
- "pan": "411111XXXXXX1111",
- "expiration_date": "2026-01-01T00:00:00+00:00",
- "issuer": "VISA",
- "transact_container": "o40dsmkQrRzPaVLP6iDEaRI+rNsBokbU6z1pRtMMzFjoHxcrhtFh3lHac+VRt3k52DpazSKGR3dHxg3V7QaNpvuY5ak9XCut+eH7IwIPwws=",
- "transact_skey_pubkey": "oyLkX4oddKGWywQCwUYNr8wq9s3tuwq6FYL3fzsBSYaT5MRgHWmAZnaTsK+fAL0A5bpkT21eDoQ3J5cUNZOqy3Uk4DTjWmveYUha9okhnWahhm59xBNvS91+fR04gsadoGO+ZawUQwzkpw5gFgC33/HoDsIMgMKwqC3n+yu8qC06mlTzsJFgY7oFH54QMD2aXnbhceXn9RswoMYKz3aWmIhrpT/YYYdEgTfUTRSjD3yOTipSYSUqoIzDa06dnseXD1ayzVNZy7scWe3/MmJV81b7cgrYbniWwBMWfZNjGIDj2ZBTa4EiN0s+nDWENKZIte+JcKPEiGlJ/J4uODdsIg==",
- "transact_skey_keyname": "weberpublic.pem",
- "transact_hash": "1f3053bc8efcd43d74997a2368738bac13bce651c3a6bae6ac90692569b69dc2ad79c88bd09c2cb99429403eb64ec5220cd18a19fa01f54126acd2d11bab1ac0"
}
}, - "callback_urls": {
}
}
{- "object": "smart.transactions",
- "id": "STX_27WNVTS2K2P6CRMGHV58RNZ7GTBXA4",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_GM35ABJ9UO23HHPIQKY9L5KT74M2BY",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_82LCT9C99SICEQXO0F309J55UC1YUD"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_3N9CJNAJ72P6CRMGHV58RNZ7GTBXA3",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "container": {
- "object": "payment.containers",
- "id": "PCT_2N7QB9Z0Z2P6CYABUGTH888KG0VDA4",
- "type": "credit_card"
}, - "transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_WD870NQHAAPR98DSZ6YKK65PJ4ECNK",
- "trans_id": 73323994,
- "transaction_hash": "wruyqvylzidy9279353"
}
], - "created": "2023-08-04T13:14:41+02:00",
- "updated": "2023-08-04T13:14:45+02:00",
- "status": "created",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket_info": {
- "sum": 3685,
- "currency": "EUR"
}, - "payment_method": "creditcard",
- "trans_id": 73323994,
- "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}, - "payment_context": {
- "auto_capture": false,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
Starts the Smart Transaction and captures the payment.
You can either pass the payment method and start it directly, or you can authorize it before with a call to POST /Smart/Transactions/{id}/prepare/{method}
. You must call /prepare
, if an external authorization might be needed (credit card 3-D Secure, PayPal, Sofort, etc.).
You can save the call to /start
when you use /prepare
in combination with auto_capture
. This will automatically start the Smart Transaction after the payment has been authorised.
In case of direct debit, you can either pass the payment data or the ID of an existing Payment Container.
Likewise you can pass the customer details or the ID of an existing Payment Customer. If not passed, it expects these details to be set before.
If started with method "cash"
, it only tracks the ECR payment so that loyalty operations can be applied.
Type "cashless"
is blocking, and starts a card payment at the payment terminal attached with SmartZVT.
smartTransactionId required | string Example: STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4 Smart Transaction ID |
paymentMethod required | string Example: prepaid Payment method, if not in succession to
|
Optional customer and/or payment details
customer | object (SmartTransactionPaymentCustomerDTO) Customer details |
container | object (SmartTransactionPaymentContainerDTO) Payment instrument |
callback_urls | object (SmartTransactionsPrepareCallbackUrls) Return URLs for external payment authorization. Note: Please don't mix them up with the return URLs for Smart Checkout. These here are intended for custom checkout implementations to catch the user when he returns from 3-D Secure, PayPal, Sofort, and the like. |
dynamic_descriptor | object (SmartTransactionsPrepareDynamicDescriptor) Dynamic Descriptor to allow the cardholder to recognize the business name and city on their card or bank statement. |
string Email address | |
tid | string Terminal ID Number (TID), required for 'cashless_direct' method |
trace | integer Trace number from the card processing response, required for 'cashless_direct' method |
cardtype | string Card Type ('visa', 'mastercard', 'mastercard_debit', 'maestro', 'vpay' or 'girocard'), required for 'cashless_direct' method |
Updated Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Payment method not available, or capture not possible or failed
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{ }
{- "object": "smart.transactions",
- "id": "STX_27WNVTS2K2P6CRMGHV58RNZ7GTBXA4",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_GM35ABJ9UO23HHPIQKY9L5KT74M2BY",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_82LCT9C99SICEQXO0F309J55UC1YUD"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_3N9CJNAJ72P6CRMGHV58RNZ7GTBXA3",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "container": {
- "object": "payment.containers",
- "id": "PCT_2N7QB9Z0Z2P6CYABUGTH888KG0VDA4",
- "type": "credit_card"
}, - "transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_WD870NQHAAPR98DSZ6YKK65PJ4ECNK",
- "trans_id": 73323994,
- "transaction_hash": "wruyqvylzidy9279353"
}
], - "created": "2023-08-04T13:14:41+02:00",
- "updated": "2023-08-04T13:14:45+02:00",
- "status": "ok",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket_info": {
- "sum": 3685,
- "currency": "EUR"
}, - "payment_method": "creditcard",
- "trans_id": 73323994,
- "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}, - "payment_context": {
- "auto_capture": false,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}
}
Adds shipping information, and marks the Payment Transaction as shipped when called the first time.
Note: This is obligatory for purchase on account, because otherwise it is not known that and when the invoice is due.
smartTransactionId required | string Example: STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4 Smart Transaction ID |
Shipping information
delivery_options | object (OneOfSmartTransactionsDeliveryOptionsModel) Delivery options, either for shipping or collection |
Updated Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "delivery_options": {
- "type": "shipping",
- "shipped_at": "2023-08-07T09:28:17+02:00",
- "shipped_by": "DHL",
- "tracking_code": "123456789",
- "invoice_number": "RG56324"
}
}
{- "object": "smart.transactions",
- "id": "STX_3R64KEXM02P6CRXPSHGS7ZFA0SX3A4",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_GM35ABJ9UO23HHPIQKY9L5KT74M2BY",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_82LCT9C99SICEQXO0F309J55UC1YUD"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_WFD55N9S82P6CRXR3GZBDJNG0M52A3",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_WH57RP8R9K7PT5VMJNBVN35PJ4ECNM",
- "trans_id": 73323996,
- "transaction_hash": "wruyqvylzidy9279353"
}
], - "created": "2023-08-04T13:17:07+02:00",
- "updated": "2023-08-07T09:35:52+02:00",
- "status": "ok",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket_info": {
- "sum": 3685,
- "currency": "EUR"
}, - "payment_method": "invoice",
- "payment_instructions": {
- "owner": "secupay AG",
- "iban": "DE81850400611005523759",
- "bic": "COBADEFFXXX",
- "bankname": "Commerzbank CC",
- "purpose": "TA 73323996",
}, - "trans_id": 73323996,
- "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}, - "payment_context": {
- "auto_capture": false,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "delivery_options": {
- "type": "shipping",
- "shipped_at": "2023-08-07T09:28:17+02:00",
- "shipped_by": "DHL",
- "tracking_code": "123456789",
- "invoice_number": "RG56324"
}
}
Abandons a Smart Transaction that has not yet been started.
smartTransactionId required | string Example: STX_3ZA5YGRB82P6A42QM84N0P9YG0Y7A4 Smart Transaction ID |
Updated Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.transactions",
- "id": "STX_2ZVEFT7YV2P6BNCP8QNQ66N4GEA0AK",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_UJC8TDR3RIZJPSNZ08DQ0L583ZWIM1",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_LQ3K36MG87J7UEMGL5M78V1PRX0M17"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_ZTADQVWAB2P6BNCP8QNQ66N4GEA0AJ",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "max@example.net",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_SEDN798YC7JKW0VVNNRRNN5PZ68XNG",
- "trans_id": 73232310,
- "transaction_hash": "wruyqvylzidy9279353"
}
], - "created": "2023-08-03T16:35:30+02:00",
- "updated": "2023-08-03T16:35:37+02:00",
- "status": "aborted",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket_info": {
- "sum": 4980,
- "currency": "EUR"
}, - "trans_id": 73232310,
- "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}, - "payment_context": {
- "auto_capture": true,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
Cancels the Smart Transaction.
smartTransactionId required | string Example: STX_2ZVEFT7YV2P6BNCP8QNQ66N4GEA0AK Smart Transaction ID |
Updated Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.transactions",
- "id": "STX_2ZVEFT7YV2P6BNCP8QNQ66N4GEA0AK",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_UJC8TDR3RIZJPSNZ08DQ0L583ZWIM1",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_LQ3K36MG87J7UEMGL5M78V1PRX0M17"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_ZTADQVWAB2P6BNCP8QNQ66N4GEA0AJ",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "max@example.net",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_SEDN798YC7JKW0VVNNRRNN5PZ68XNG",
- "trans_id": 73232310,
- "transaction_hash": "wruyqvylzidy9279353"
}
], - "created": "2023-08-03T16:35:30+02:00",
- "updated": "2023-08-03T16:35:37+02:00",
- "status": "cancelled",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket_info": {
- "sum": 4980,
- "currency": "EUR"
}, - "payment_method": "prepaid",
- "trans_id": 73232310,
- "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_WD0DE66HN2XWJHW8JM88003YG0NEA2",
- "language": "de"
}, - "payment_context": {
- "auto_capture": true,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
Cancels the terminal-induced "cash"
transaction with the given receipt number.
smartTransactionId required | string Example: 3 Receipt number |
Updated Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.transactions",
- "id": "STX_WBVJKK82Y2X3MKHN3NZCPAAF6C38AJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_GM35ABJ9UO23HHPIQKY9L5KT74M2BY",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_82LCT9C99SICEQXO0F309J55UC1YUD"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_3N9CJNAJ72P6CRMGHV58RNZ7GTBXA3",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [ ],
- "created": "2023-08-04T13:22:56+02:00",
- "updated": "2023-08-07T09:53:18+02:00",
- "status": "cancelled",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket": {
- "products": [
- {
- "id": 1,
- "articleNumber": "30037",
- "desc": "Sandwich Romano",
- "quantity": 1,
- "priceOne": 349,
- "tax": 7,
- "item_type": "article"
}, - {
- "id": 2,
- "articleNumber": "30200",
- "desc": "Obstsalat",
- "quantity": 1,
- "priceOne": 249,
- "tax": 7,
- "item_type": "article"
}, - {
- "id": 3,
- "articleNumber": "51",
- "ean": "4999012345678",
- "desc": "Mineralwasser 0,5l",
- "quantity": 2,
- "priceOne": 99,
- "tax": 19,
- "item_type": "article"
}, - {
- "id": 4,
- "articleNumber": "111000007",
- "quantity": 1,
- "priceOne": -15,
- "tax": 7,
- "desc": "Bonus 7% USt"
}, - {
- "id": 5,
- "articleNumber": "111000019",
- "quantity": 1,
- "priceOne": -5,
- "tax": 19,
- "desc": "Bonus 19% USt"
}
], - "type": "default"
}, - "basket_info": {
- "sum": 796,
- "missing_sum": 576,
- "currency": "EUR"
}, - "payment_method": "cash",
- "trans_id": 55679607,
- "is_demo": true,
- "receipt_number": 3,
- "payment_context": {
- "auto_capture": false,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}
}
Requests new authorization for a subscription.
The Payment Container for a subscription may have become unusable. For instance may the customer have returned their card or changed their bank account.
The returned Smart Transaction is to be used like after a call to /prepare
. There are URLs inside payment_links
to authorize for credit card, SEPA direct debit or with PayPal.
subscriptionId required | string Subscription ID |
Newly created Smart Transaction for the new authorization
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.transactions",
- "id": "STX_3EM6ECE9P2P6CQVYWN0SQH9HGFZ6A4",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_GM35ABJ9UO23HHPIQKY9L5KT74M2BY",
- "companyname": "Musterhändler GmbH"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_82LCT9C99SICEQXO0F309J55UC1YUD"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_208BVAXVX2P6CQVYWN0SQH9HGFZ6A3",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "dob": "1980-01-01T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55a",
- "additional_address_data": "Whg. 203",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}
}, - "transactions": [ ],
- "created": "2023-08-04T12:50:18+02:00",
- "status": "created",
- "transactionRef": "Bestellnr. 20000345 bei Example.com",
- "merchantRef": "20000345",
- "intent": "sale",
- "basket": {
- "products": [
- {
- "id": 1,
- "item_type": "subscription",
- "desc": "Abo Beispielzeitung (incl. Tablet PC für 99 EUR, 3 Probewochen á 99 ct, dann 9,90 EUR p. M.)",
- "quantity": 1,
- "priceOne": 9900,
- "tax": 19,
- "plan_id": "PLN_V8ZKZDPTTW0CJ9520BPV60NLGJ59YB",
- "start_at": "2023-09-01T00:00:00Z"
}
], - "type": "default"
}, - "basket_info": {
- "sum": 9900,
- "currency": "EUR"
}, - "is_demo": true,
- "application_context": {
- "return_urls": {
}, - "checkout_template": "COT_QV85D3F542XWFFJYCSWG00W400YWAT",
- "language": "de"
}, - "payment_context": {
- "auto_capture": true,
- "merchant_initiated": false,
- "accrual": false,
- "creditcard_schemes": [
- "mastercard",
- "visa",
- "american express",
- "cup"
]
}, - "payment_links": {
}
}
Runs the end of day report on the POS payment terminal. This operation is usually called by SDKs from the electronic cash register (ECR).
This request is blocking. Secuconnect API only answers after the payment terminal has finished the end-of-day report.
smartDeviceId required | string Example: me Smart Device ID |
Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.transactions",
- "id": "STX_2PR98002A2X6WVHJC12VHAGQ05N2A4",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_2E3VNPKAVSF12BHX82T97DK4PED8PJ",
- "companyname": "secucard Demo-Händler"
}, - "device_source": {
- "object": "smart.devices",
- "id": "SDV_AWWXBYB8A2X6WV0QSQ5Q12E6349CAM"
}, - "created": "2021-06-10T13:49:58+02:00",
- "updated": "2021-06-10T13:50:30+02:00",
- "status": "ok",
- "receipt": [
- {
- "type": "separator",
- "value": {
- "caption": "Kassenschnitt"
}
}, - {
- "type": "textline",
- "value": {
- "text": "INGENICO",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Test",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "10.06.2021",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Uhrzeit:",
- "value": "13:50:00 Uhr",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Trace-Nr.",
- "value": "000013",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Kassenschnitt",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Terminal-ID",
- "value": "11987654",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Beleg-Nr. 0001 - 0003",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Währung",
- "value": "EUR",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Karte Anzahl EUR",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "girocard 3 0,01",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Masterc. 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "AMEX 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Visa 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Maestro 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "VPAY 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "VISAEL 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "UnionPay 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "ElV-Spur2 0 0,00",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "------------------------",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Gesamt 3 0,01",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Detailkassenschnitt",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Karte Beleg Betrag",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "girocard 1 0,01",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "girocard 2 0,01",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "girocard 3 0,01-",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Kassenschnitt",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "erfolgreich",
- "decoration": [ ]
}
}
]
}
Runs the diagnosis process on the POS payment terminal (PT). This operation is usually called by SDKs from the electronic cash register (ECR).
This request is blocking. Secuconnect API only answers after the payment terminal has finished the end-of-day report.
smartDeviceId required | string Example: me Smart Device ID |
Smart Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.transactions",
- "id": "STX_3462KF9P12X2BCHTD3H588YVNG34AH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_2E3VNPKAVSF12BHX82T97DK4PED8PJ",
- "companyname": "secucard Demo-Händler"
}, - "device_source": {
- "object": "smart.devices",
- "id": "SDV_2K2NKV07V2X29QCUT3H58EKQ6Y12A2"
}, - "created": "2021-03-12T13:54:18+01:00",
- "updated": "2021-03-12T13:54:33+01:00",
- "status": "ok",
- "receipt": [
- {
- "type": "separator",
- "value": {
- "caption": "Diagnose"
}
}, - {
- "type": "textline",
- "value": {
- "text": "Testterminal",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Goethestrasse 6",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "01896 Pulsnitz",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "12.03.2021",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Uhrzeit:",
- "value": "13:54:00 Uhr",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Trace-Nr.",
- "value": "000353",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Erweiterte Diagnose",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Terminal-ID",
- "value": "69123456",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Testterminal",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Goethestrasse 6",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "01896 Pulsnitz",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Offline-Zähler: 5",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "girocard:",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Floorlimit",
- "value": "0 EUR",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Tageslimit",
- "value": "FF",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "NoPIN-Limit",
- "value": "0 EUR",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Maestro:",
- "value": "gesperrt",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "GeldKarte:",
- "value": "freigegeben",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Diagnose erfolgreich",
- "decoration": [ ]
}
}
]
}
Payment Transactions control the actual payment. When you work with Smart Transactions, the needed Payment Transaction is created in the background when calling POST /Smart/Transactions/{id}/prepare or POST /Smart/Transactions/{id}/start. There are also additional Payment Transactions for things like stakeholder payments, refunds, and the like. These are linked with the original Payment Transaction.
Returns the Payment Transactions matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Transactions
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 13264,
- "data": [
- {
- "object": "payment.transactions",
- "id": "PCI_50SNAHJC6YDBYNKWQCT6BXSB7J4SO5",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_UB4TL4VL8CMRHXNFJDBG5YBF0FJXYK",
- "type": "11",
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH"
}
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
}, - "trans_id": 6799385,
- "product_id": 329,
- "product": "Kauf auf Rechnung (Demo)",
- "product_raw": "Kauf auf Rechnung (Demo)",
- "zahlungsmittel_id": 0,
- "contract_id": 49760,
- "amount": 199,
- "currency": "EUR",
- "created": "2016-04-28T11:12:40+02:00",
- "updated": "2016-04-28T11:12:40+02:00",
- "description": "Testbestellung #1",
- "description_raw": "Testbestellung #1",
- "status": 1,
- "status_text": "erstellt",
- "details": {
- "cleared": "open",
- "status": 1,
- "status_text": "erstellt",
- "status_simple": 99,
- "status_simple_text": "created",
- "amount": 199,
- "description": "Testbestellung #1",
- "description_raw": "Testbestellung #1"
}, - "customer": {
- "salutation": "Frau",
- "forename": "Marie",
- "surname": "Mustermann",
- "name": "Marie Mustermann"
}, - "transaction_hash": "bxxdkdlcexgt10709743",
- "accrual": true
}
]
}
Creates a new Payment Transaction from the given data for TWINT.
Transaction details
amount | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
currency | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
purpose | string The purpose of the payment, for the account statement for example. |
payment_methods | Array of strings Nullable Payment methods.
|
order_id | string Your order number. If set for the contract, there must be a unique number for each payment. |
basket | Array of objects (SecupayBasketItem) Basket items, several sub-baskets or subscription details |
accrual | boolean Locks for payout, if set on |
payment_action | string Specifies whether to authorize only ( |
customer | object (PaymentCustomersProductModel) Default: {} Customer details |
redirect_url | object (SecupayRedirectUrl) SecupayRedirectUrl |
contract | string Contract ID |
container | string Container ID |
opt_data | object Options for customizing the checkout page |
subscription | object (SecupayTransactionProductDTOSubscription) Recurring payments |
demo | boolean Demo mode |
experience | object Customer experience score |
Newly created Payment Transaction
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "demo": false,
- "contract_id": "GCR_HGEZ958JZWVKLEBUNYV87TTLXHFDEA",
- "customer": {
- "contact": {
- "forename": "Max",
- "surname": "Mustermann",
- "phone": "+49 555 5555555",
- "mobile": "+49 177 5555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19 a",
- "additional_address_data": "Whg. 201",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}, - "email": "max@example.net",
- "dob": "1965-12-31"
}
}, - "amount": 1995,
- "currency": "CHF",
- "purpose": "Kauf bei Example.com",
- "payment_methods": [
- "TWINT"
], - "redirect_url": {
}
}
{- "object": "payment.transactions",
- "id": "gqaymbtaduzc7420193",
- "trans_id": 71734972,
- "payment_id": "PCI_W5SNC4GVPHXX0KC4NPZYA95XN6ZBNZ",
- "status": "internal_server_status",
- "amount": 1995,
- "currency": "CHF",
- "purpose": "Kauf bei Example.com",
- "transaction_status": 1,
- "accrual": false,
- "customer": {
- "object": "payment.customers",
- "id": "PCU_3UAH8NE2E2P5EMJVP2JT0FFAGVRUAJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_PXSBZGSQZ7G9P16EUVNX8RLCAOS0WI"
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "dob": "1965-12-31T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19a",
- "additional_address_data": "Whg. 201",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-12T16:13:19+02:00"
}, - "redirect_url": {
},
}
Returns the specified Payment Transaction.
paymentTransactionId required | string Payment Transaction ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.transactions",
- "id": "PCI_23XAR0HTRVA2ZM0STUB0J248W0U9MG",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_B3TJZ9709O4B0QCVM3DVSEIIWQJAD5",
- "type": 46,
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH",
- "project_name": "Example.com"
}
}, - "platform": {
- "object": "general.merchants",
- "id": "MRC_W1R18ABI0ATC4D9RE6FM43E97SO226"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_3F8W5G5AREXUXHJYUXEA53F9WG5KPX"
}, - "related_transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_W0V0CC75TKRQP85ANESFXK5Q7E44N8",
- "hierarchy": "child",
- "ref_type_id": 19,
- "ref_type_raw": "Gutschrift / Refund",
- "trans_id": 120184852
}
], - "trans_id": 119879108,
- "product_id": 16,
- "product": "Direct debit",
- "product_raw": "Zahlungsgarantie Lastschrift",
- "zahlungsmittel_id": 1796483,
- "contract_id": 81698,
- "amount": 13000,
- "currency": "EUR",
- "created": "2023-06-29T16:50:47+02:00",
- "completion_date": "2023-06-29T16:50:48+02:00",
- "updated": "2023-06-29T16:59:57+02:00",
- "description": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)",
- "status": 6,
- "status_text": "abgeschlossen",
- "details": {
- "cleared": "open",
- "status": 6,
- "status_text": "abgeschlossen",
- "status_simple": 1,
- "status_simple_text": "accepted",
- "amount": 13000,
- "description": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)"
}, - "customer": {
- "forename": "Maritta",
- "surname": "Mustermann",
- "name": "Maritta Mustermann",
- "email": "maritta@example.net",
- "address": [ ]
}, - "payment_data": "DE37 XXXX XXXX XXXX XX05 24",
- "transaction_hash": "bxxdkdlcexgt10709743",
- "accrual": false,
- "order_id": "50001234"
}
Captures an authorised invoice Payment Transaction.
Note: For invoice payment, this must be invoked. Otherwise it is not known that and when the invoice becomes due.
Note: This works only for authorised invoice payment transactions. The transaction must have status 85 as a pre-condition.
paymentTransactionId required | string Payment Transaction ID |
amount | integer Optional parameter for MoTo Transactions to capture a new amount which has to be equal or less than the authorized amount of the transaction. |
shipping_information | object (SecupayTransactionSetShippingInformationDTO) Shipping information (incl. invoice number and order ID) |
Updated Payment Transaction
Response related to the error
Production environment
Testing environment
Staging environment
{ }
{- "object": "payment.transactions",
- "id": "PCI_3JSVHBEBA3XNCP6Y46BZX248W25BM7",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_OS4P1HDGIDJU4Y939HAS1DM2J4AUAL",
- "type": 46,
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH",
- "project_name": "Example.com"
}, - "parent": {
- "object": "general.merchants",
- "id": "MRC_5D1Q5MQ0S3T0R5TMZNQ1T9DX0U9ZUM",
- "type": 4
}
}, - "platform": {
- "object": "general.merchants",
- "id": "MRC_5D1Q5MQ0S3T0R5TMZNQ1T9DX0U9ZUM"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
}, - "related_transactions": [ ],
- "trans_id": 110111567,
- "product_id": 329,
- "product": "Kauf auf Rechnung (Demo)",
- "product_raw": "Kauf auf Rechnung (Demo)",
- "zahlungsmittel_id": 0,
- "contract_id": 49760,
- "amount": 1250,
- "currency": "EUR",
- "created": "2023-07-12T09:41:47+02:00",
- "updated": "2023-07-12T09:42:11+02:00",
- "completion_date": "2024-12-04T00:00:00+01:00",
- "description": "Bestellung am 12.07.2023 via secupay bei Musterfirma GmbH (264748)",
- "description_raw": "Bestellung am 12.07.2023 via secupay bei Musterfirma GmbH (264748)",
- "status": 86,
- "status_text": "abgeschlossen (Rechnung offen)",
- "details": {
- "cleared": "open",
- "status": 86,
- "status_text": "abgeschlossen (Rechnung offen)",
- "status_simple": 1,
- "status_simple_text": "accepted",
- "amount": 3685,
- "description": "Bestellung am 04.12.2024 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 04.12.2024 via secupay bei Secupay Test-Shop (264748)"
}, - "customer": {
- "salutation": "Herr",
- "title": null,
- "forename": "Max",
- "surname": "Mustermann",
- "name": "Max Mustermann",
- "companyname": null,
- "project_name": null,
- "email": "max@example.net",
- "phone": null,
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "55a Whg. 203",
- "short_name": "55a Whg. 203",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstraße",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstraße 55a Whg. 203, 09123 Musterstadt, Germany"
}
]
}, - "transaction_hash": "vyemyhtuqvun11132775",
- "accrual": false,
- "order_id": "ORD-12345"
}
Cancels or refunds the payment in full or in part.
Note: It is not possible to exceed the original amount.
If the payer has already made the payment, it creates a new Payment Transaction for the refund, and links it to the original one. The amount of the original Payment Transaction then remains unchanged.
If the payment was not made yet, the amount is reduced (partial cancellation) or the status is set to cancelled (full cancellation). There will be no additional Payment Transaction.
The amount still in effect can be read with GET /Payment/Transactions/{id}/checkStatus
.
paymentTransactionId required | string Payment Transaction ID |
Amount and reason
reason | string <[0-9a-zA-Z .,+\-:?()\/\']+> The reason of this cancel or refund |
amount | integer Deprecated Amount in smallest currency unit (e. g. Euro Cent) |
reduce_amount_by | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
reduce_stakeholder_payment | boolean Default: false Only for the mixed basket. Reduces stakeholder shares proportionately. |
container_id | string Payment Container ID |
Updated Payment Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "reduce_amount_by": 1000,
- "reason": "Nachlass fuer kleinen Fleck"
}
{- "object": "payment.transactions",
- "id": "PCI_23XAR0HTRVA2ZM0STUB0J248W0U9MG",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_B3TJZ9709O4B0QCVM3DVSEIIWQJAD5",
- "type": 46,
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH",
- "project_name": "Example.com"
}
}, - "platform": {
- "object": "general.merchants",
- "id": "MRC_W1R18ABI0ATC4D9RE6FM43E97SO226"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_3F8W5G5AREXUXHJYUXEA53F9WG5KPX"
}, - "related_transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_W0V0CC75TKRQP85ANESFXK5Q7E44N8",
- "hierarchy": "child",
- "ref_type_id": 19,
- "ref_type_raw": "Gutschrift / Refund",
- "trans_id": 120184852
}
], - "trans_id": 119879108,
- "product_id": 16,
- "product": "Direct debit",
- "product_raw": "Zahlungsgarantie Lastschrift",
- "zahlungsmittel_id": 1796483,
- "contract_id": 81698,
- "amount": 13000,
- "currency": "EUR",
- "created": "2023-06-29T16:50:47+02:00",
- "completion_date": "2023-06-29T16:50:48+02:00",
- "updated": "2023-06-29T16:59:57+02:00",
- "description": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)",
- "status": 6,
- "status_text": "abgeschlossen",
- "details": {
- "cleared": "open",
- "status": 6,
- "status_text": "abgeschlossen",
- "status_simple": 1,
- "status_simple_text": "accepted",
- "amount": 13000,
- "description": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 29.06.2023 via secupay bei Secupay Test-Shop (264748)"
}, - "customer": {
- "forename": "Maritta",
- "surname": "Mustermann",
- "name": "Maritta Mustermann",
- "email": "maritta@example.net",
- "address": [ ]
}, - "payment_data": "DE37 XXXX XXXX XXXX XX05 24",
- "transaction_hash": "bxxdkdlcexgt10709743",
- "accrual": false,
- "order_id": "50001234"
}
Revokes the accrual flag of a Payment Transaction. This flag withholds the actual execution of the payment. The payment will now be made if it has not already been made.
paymentTransactionId required | string Payment Transaction ID |
Updated Payment Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Accrual change not allowed
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.transactions",
- "id": "PCI_3JSVHBEBA3XNCP6Y46BZX248W25BM7",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_OS4P1HDGIDJU4Y939HAS1DM2J4AUAL",
- "type": 46,
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH",
- "project_name": "Example.com"
}, - "parent": {
- "object": "general.merchants",
- "id": "MRC_5D1Q5MQ0S3T0R5TMZNQ1T9DX0U9ZUM",
- "type": 4
}
}, - "platform": {
- "object": "geneöral.merchants",
- "id": "MRC_5D1Q5MQ0S3T0R5TMZNQ1T9DX0U9ZUM"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
}, - "related_transactions": [ ],
- "trans_id": 110111567,
- "product_id": 329,
- "product": "Kauf auf Rechnung (Demo)",
- "product_raw": "Kauf auf Rechnung (Demo)",
- "zahlungsmittel_id": 0,
- "contract_id": 49760,
- "amount": 1250,
- "currency": "EUR",
- "created": "2023-07-12T09:41:47+02:00",
- "updated": "2023-07-12T09:42:11+02:00",
- "description": "Bestellung am 12.07.2023 via secupay bei Musterfirma GmbH (264748)",
- "description_raw": "Bestellung am 12.07.2023 via secupay bei Musterfirma GmbH (264748)",
- "status": 85,
- "status_text": "Kauf auf Rechnung genehmigt",
- "details": {
- "cleared": "open",
- "status": 85,
- "status_text": "Kauf auf Rechnung genehmigt",
- "status_simple": 14,
- "status_simple_text": "waiting for shipment",
- "amount": 1250,
- "description": "Bestellung am 12.07.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 12.07.2023 via secupay bei Secupay Test-Shop (264748)"
}, - "customer": {
- "forename": "Maritta",
- "surname": "Mustermann",
- "name": "Maritta Mustermann",
- "email": "maritta@example.net",
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "19",
- "short_name": "19",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstr.",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstr. 19, 09123 Musterstadt, Germany"
}
]
}, - "transaction_hash": "bxxdkdlcexgt10709743",
- "accrual": false
}
POST Payment/Transactions/{paymentTransactionId}/getPaymentInstructions
paymentTransactionId required | string Payment Transaction ID |
Payment Instructions
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "lang": "de_DE",
- "amount": "140,00",
- "currency": "EUR",
- "payment_instructions": {
- "iban": "DE81850400611005523759",
- "bic": "COBADEFFXXX",
- "owner": "secupay AG",
- "bankname": "Commerzbank CC",
- "purpose": "TA 74771101 DT 2023-08-31 08:41:23"
}
}
POST Payment/Transactions/me/getPaymentInstructions/{smartTransactionId}
smartTransactionId required | string Smart Transaction ID |
Payment Instructions
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "lang": "de_DE",
- "amount": "140,00",
- "currency": "EUR",
- "payment_instructions": {
- "iban": "DE81850400611005523759",
- "bic": "COBADEFFXXX",
- "owner": "secupay AG",
- "bankname": "Commerzbank CC",
- "purpose": "TA 74771101 DT 2023-08-31 08:41:23"
}
}
Returns the specified Payment Transaction in old format.
paymentTransactionId required | string Payment Transaction ID (PCI_...) or Flex.API transaction hash |
Payment Transaction in old format
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.transactions",
- "id": "gqaymbtaduzc7420193",
- "trans_id": 71734972,
- "payment_id": "PCI_W5SNC4GVPHXX0KC4NPZYA95XN6ZBNZ",
- "status": "internal_server_status",
- "amount": 1995,
- "currency": "EUR",
- "purpose": "Kauf bei Example.com",
- "transaction_status": 1,
- "accrual": false,
- "payment_action": "sale",
- "customer": {
- "object": "payment.customers",
- "id": "PCU_3UAH8NE2E2P5EMJVP2JT0FFAGVRUAJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_PXSBZGSQZ7G9P16EUVNX8RLCAOS0WI"
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "dob": "1965-12-31T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19a",
- "additional_address_data": "Whg. 201",
- "postal_code": "09123",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-12T16:13:19+02:00"
}, - "redirect_url": {
},
}
Returns a crowd funding summary for the given merchant. It contains the transaction amounts, counts and payout data for each payment method ("product").
generalMerchantId required | string Example: MRC_LTV1LATRBD58BGUMMN2HTA1S8G17P9 General Merchant ID (MRC_...) |
Crowd funding summary
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "project": {
- "currency": "EUR",
- "total_amount": 810000,
- "total_count": 87,
- "debit": {
- "count": 27,
- "amount": 260000
}, - "credit_card": {
- "count": 32,
- "amount": 340000
}, - "prepay": {
- "count": 11,
- "amount": 70000
}, - "sofort": {
- "count": 17,
- "amount": 140000
}, - "twint": {
- "count": 0,
- "amount": 0
}, - "aiia": {
- "count": 0,
- "amount": 0
}
}, - "deposited_amount": 544000,
- "paid_out": 590000,
- "deducted_amount": 46000,
- "open": {
- "total": 220000,
- "outside_cancellation_period": {
- "total": 130000
}, - "inside_cancellation_period": {
- "total": 40000,
- "debit": 30000,
- "credit_card": 10000,
- "prepay": 5000,
- "sofort": 5000,
- "twint": 0,
- "aiia": 0
}
}
}
Adds shipping information.
paymentTransactionId required | string Payment Transaction ID (PCI_...) or Flex.API transaction hash |
Shipping information
carrier | string Shipping provider name |
tracking_id | string Tracking code |
invoice_number | string Merchant's invoice number |
shipped_at | string Shipping date and time, if not in the very moment; ISO 8601 date and time including timezone, like "2023-02-28T10:55:27+02:00" |
order_id | string Merchant's order number |
Whether it was successful
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Shipping information update not allowed
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "carrier": "ACME Parcel, Inc.",
- "tracking_id": "a12bc345d67ef8g90"
}
{- "result": true
}
Assign Incoming Payment to Payment Transaction
paymentTransactionId required | string Payment Transaction ID |
accountingId required | integer Accounting ID |
Updated Payment Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.transactions",
- "id": "PCI_JWF8YC9HC5TAD9603J4SPT5Q7E48NW",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_OS4P1HDGIDJU4Y939HAS1DM2J4AUAL",
- "type": 46,
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH",
- "project_name": "Example.com"
}
}, - "platform": {
- "object": "general.merchants",
- "id": "MRC_5D1Q5MQ0S3T0R5TMZNQ1T9DX0U9ZUM"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
}, - "related_transactions": [ ],
- "trans_id": 74771101,
- "product_id": 36,
- "product": "Payment in advance",
- "product_raw": "Vorkasse",
- "zahlungsmittel_id": 0,
- "contract_id": 49760,
- "amount": 14000,
- "currency": "EUR",
- "created": "2023-08-31T08:41:23+02:00",
- "updated": "2023-08-31T08:41:43+02:00",
- "description": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)",
- "status": 25,
- "status_text": "Vorkasse wartend",
- "details": {
- "cleared": "open",
- "status": 25,
- "status_text": "Vorkasse wartend",
- "status_simple": 10,
- "status_simple_text": "pending",
- "amount": 14000,
- "description": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)"
}, - "customer": {
- "forename": "Maritta",
- "surname": "Mustermann",
- "name": "Maritta Mustermann",
- "email": "maritta@example.net",
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "19",
- "short_name": "19",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstr.",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstr. 19, 09123 Musterstadt, Germany"
}
]
}, - "transaction_hash": "jrxctjrwwxqz7644869",
- "accrual": false,
- "order_id": "50002345"
}
Increases the amount of the given Payment Transaction. Currently, this only works for prepayment, and only before the payment has been received by secupay.
paymentTransactionId required | string Payment Transaction ID |
increase amount input params
amount | integer New amount of the transaction, in the smallest currency unit (e. g. Euro Cent) |
Updated Payment Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "amount": 14000
}
{- "object": "payment.transactions",
- "id": "PCI_JWF8YC9HC5TAD9603J4SPT5Q7E48NW",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_OS4P1HDGIDJU4Y939HAS1DM2J4AUAL",
- "type": 46,
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH",
- "project_name": "Example.com"
}
}, - "platform": {
- "object": "general.merchants",
- "id": "MRC_5D1Q5MQ0S3T0R5TMZNQ1T9DX0U9ZUM"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
}, - "related_transactions": [ ],
- "trans_id": 74771101,
- "product_id": 36,
- "product": "Payment in advance",
- "product_raw": "Vorkasse",
- "zahlungsmittel_id": 0,
- "contract_id": 49760,
- "amount": 14000,
- "currency": "EUR",
- "created": "2023-08-31T08:41:23+02:00",
- "updated": "2023-08-31T08:41:43+02:00",
- "description": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)",
- "status": 25,
- "status_text": "Vorkasse wartend",
- "details": {
- "cleared": "open",
- "status": 25,
- "status_text": "Vorkasse wartend",
- "status_simple": 10,
- "status_simple_text": "pending",
- "amount": 14000,
- "description": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)",
- "description_raw": "Bestellung am 31.08.2023 via secupay bei Secupay Test-Shop (264748)"
}, - "customer": {
- "forename": "Maritta",
- "surname": "Mustermann",
- "name": "Maritta Mustermann",
- "email": "maritta@example.net",
- "address": [
- {
- "type": "invoice",
- "address_components": [
- {
- "long_name": "19",
- "short_name": "19",
- "types": [
- "street_number"
]
}, - {
- "long_name": "Musterstr.",
- "short_name": "Musterstr.",
- "types": [
- "route"
]
}, - {
- "long_name": "Musterstadt",
- "short_name": "Musterstadt",
- "types": [
- "locality",
- "political"
]
}, - {
- "long_name": "Germany",
- "short_name": "DE",
- "types": [
- "country",
- "political"
]
}, - {
- "long_name": "09123",
- "short_name": "09123",
- "types": [
- "postal_code"
]
}
], - "address_formatted": "Musterstr. 19, 09123 Musterstadt, Germany"
}
]
}, - "transaction_hash": "jrxctjrwwxqz7644869",
- "accrual": false,
- "order_id": "50002345"
}
Returns the current status and amount still in effect. The amount considers open and completed refunds. The amount is zero if the transaction was fully cancelled.
paymentTransactionId required | string Payment Transaction ID |
Status and actual amount
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "status": 9,
- "status_text": "vorautorisiert",
- "status_simple": 2,
- "status_simple_text": "authorized",
- "amount": 1995,
- "currency": "EUR"
}
Assigns balance to a Payment Transaction for payout. The merchant must have sent the balance by bank transfer, before it can be assigned and paid out.
paymentTransactionId required | string Payment Transaction ID |
Updated Payment Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.transactions",
- "id": "PCI_WM7Z28CR5CJV79EB9UWWMK5Q7E48NH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_OS4P1HDGIDJU4Y939HAS1DM2J4AUAL",
- "type": 46,
- "user": {
- "name": "Max Mustermann",
- "companyname": "Musterfirma GmbH",
- "project_name": "Example.com"
}
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
}, - "related_transactions": [
- {
- "object": "payment.transactions",
- "id": "PCI_YTJXPRNB9748CQW9F6V23G5Q7E48NZ",
- "hierarchy": "child",
- "ref_type_id": 75,
- "ref_type_raw": "API Auszahlung",
- "trans_id": 74771112
}, - {
- "object": "payment.transactions",
- "id": "PCI_8D3QAE6YYWVYGC2MYMBSX35Q7E48NJ",
- "hierarchy": "child",
- "ref_type_id": 75,
- "ref_type_raw": "API Auszahlung",
- "trans_id": 74771113
}, - {
- "object": "payment.transactions",
- "id": "PCI_WA9N8NR54F95F82XJAQGH75Q7E48NK",
- "hierarchy": "child",
- "ref_type_id": 75,
- "ref_type_raw": "API Auszahlung",
- "trans_id": 74771114
}
], - "trans_id": 74771111,
- "product_id": 402,
- "product": "API initiierte Auszahlung",
- "product_raw": "API initiierte Auszahlung",
- "zahlungsmittel_id": 0,
- "contract_id": 49760,
- "amount": 94892,
- "currency": "EUR",
- "created": "2023-08-31T09:03:22+02:00",
- "completion_date": "2023-08-24T00:00:00+02:00",
- "updated": "2023-08-31T09:03:40+02:00",
- "description": "Payout UPLOAD 2023-08-31",
- "description_raw": "Payout UPLOAD 2023-08-31",
- "status": 6,
- "status_text": "abgeschlossen",
- "details": {
- "cleared": "open",
- "status": 6,
- "status_text": "abgeschlossen",
- "status_simple": 1,
- "status_simple_text": "accepted",
- "amount": 8,
- "description": "Payout UPLOAD 2023-08-31",
- "description_raw": "Payout UPLOAD 2023-08-31"
}
}
Get Refund Bank Account
trans_id | integer Transaction ID |
Get Transaction Id and Refund Bank Account
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "trans_id": 55873127
}
{- "trans_id": 55873127,
- "bank_account": {
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "owner": "Max Mustermann",
- "bankname": "Deutsche Kreditbank Berlin"
}
}
A Payment Customer holds the details of a private person or a business, including postal address and other contact details. It is used as invoice or shipping address. The Payment Customer can be created implicitly from the Smart Transaction or explicitly using POST /Payment/Customers. Payment Customers are used for payment operations, while Loyalty Customers are for customer loyalty programmes (secuaction).
Returns the Payment Customers matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Customers
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 70,
- "data": [
- {
- "object": "payment.customers",
- "id": "PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5UXMPVN9YCTRBBSUUDA6IV6T4SZNUI",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_ZZE2RVYD029BJPXWEP92D5BNPNNQW0",
- "type": 4
}
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "gender": "male",
- "dob": "1985-03-27T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19b",
- "additional_address_data": "Whg. 201",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-11T13:20:06+02:00"
}, - {
- "object": "payment.customers",
- "id": "PCU_Q62B4WRUC2P5D7F63ZG2KDJEG9QVA3",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5UXMPVN9YCTRBBSUUDA6IV6T4SZNUI",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_ZZE2RVYD029BJPXWEP92D5BNPNNQW0",
- "type": 4
}
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "companyname": "Musterfirma GmbH",
- "email": "m.mustermann@example.com",
- "phone": "+495555555555",
- "address": {
- "street": "Musterallee",
- "street_number": "21-23",
- "additional_address_data": "Haus C",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-11T13:23:56+02:00"
}
]
}
Creates a new Payment Customer with the given data.
Details of the new Payment Customer
contact | object (Contact) Contact details |
Newly created Payment Customer
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "contact": {
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "gender": "male",
- "address": {
- "street": "Musterstr.",
- "street_number": "19 b",
- "additional_address_data": "Whg. 201",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}, - "email": "max@example.net",
- "phone": "+49 555 5555555",
- "mobile": "+49 177 5555555",
- "dob": "1985-03-27"
}
}
{- "object": "payment.customers",
- "id": "PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5UXMPVN9YCTRBBSUUDA6IV6T4SZNUI",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_ZZE2RVYD029BJPXWEP92D5BNPNNQW0",
- "type": 4
}
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "gender": "male",
- "dob": "1985-03-27T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19b",
- "additional_address_data": "Whg. 201",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-11T13:20:06+02:00"
}
Returns the specified Payment Customer.
paymentCustomerId required | string Example: PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ Payment Customer ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Customer
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.customers",
- "id": "PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5UXMPVN9YCTRBBSUUDA6IV6T4SZNUI",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_ZZE2RVYD029BJPXWEP92D5BNPNNQW0",
- "type": 4
}
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "gender": "male",
- "dob": "1985-03-27T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19b",
- "additional_address_data": "Whg. 201",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-11T13:20:06+02:00"
}
Updates the specified Payment Customer with the given data.
paymentCustomerId required | string Example: PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ Payment Customer ID |
Payment customer properties
contact | object (Contact) Contact details |
Updated Payment Customer
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "contact": {
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "gender": "male",
- "address": {
- "street": "Musterstr.",
- "street_number": "19 b",
- "additional_address_data": "Whg. 201",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}, - "email": "max@example.net",
- "phone": "+49 555 5555555",
- "mobile": "+49 177 5555555",
- "dob": "1985-03-27"
}
}
{- "object": "payment.customers",
- "id": "PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5UXMPVN9YCTRBBSUUDA6IV6T4SZNUI",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_ZZE2RVYD029BJPXWEP92D5BNPNNQW0",
- "type": 4
}
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "gender": "male",
- "dob": "1985-03-27T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19b",
- "additional_address_data": "Whg. 201",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-11T13:20:06+02:00",
- "updated": "2023-07-11T13:21:17+02:00"
}
Deletes the specified Payment Customer.
paymentCustomerId required | string Example: PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ Payment Customer ID |
Deleted Payment Customer
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.customers",
- "id": "PCU_3V7SC84922P5D7BJ73VCZ8S70XAMAJ",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5UXMPVN9YCTRBBSUUDA6IV6T4SZNUI",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_ZZE2RVYD029BJPXWEP92D5BNPNNQW0",
- "type": 4
}
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "salutation": "Herr",
- "gender": "male",
- "dob": "1985-03-27T00:00:00+00:00",
- "email": "max@example.net",
- "phone": "+495555555555",
- "mobile": "+491775555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "19b",
- "additional_address_data": "Whg. 201",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2023-07-11T13:20:06+02:00"
}
Payment Containers hold reusable payment instruments for SEPA direct debit or for credit card payment. They can be created implicitly with POST /Smart/Transactions/{id}/prepare
. Some subtypes can also be created with POST /Payment/Containers
. Every Payment Container is restricted to the merchant who has created it.
Returns the Payment Containers matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Containers
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 1,
- "data": [
- {
- "object": "payment.containers",
- "id": "PCT_8NGN7YVKH2P2UWYVZRYDQ6MQ06GWA2",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5UXMPVN9YCTRBBSUUDA6IV6T4SZNUI"
}, - "type": "bank_account",
- "private": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "public": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "mandate": {
- "sepa_mandate_id": 692806,
- "type": "CORE",
- "identification": "OTM/A50BL8OR64E86IA06",
- "mandate_date": "2020-03-30T11:57:19+02:00"
}, - "created": "2023-05-12T11:57:19+02:00"
}
]
}
Creates a new Payment Container from the given data.
Important note: As of end of April 2024 you cannot create Payment Containers with type credit_card
anymore. Your application needs to create these Payment Containers implicitly with POST /Smart/Transactions/{id}/prepare/{method}
.
If your application uses the deprecated way, you are demanded to revise your integration.
With the sole exception of bank account details for payouts (outgoing bank transfers), we recommend to use the implicit creation as described above everywhere in your application.
Payment Container properties
merchant_id | string Nullable General Merchant ID |
customer | object Nullable Deprecated The customer the Payment Container belongs to |
customer_id | string Nullable Payment Customer ID |
type | string Container type:
|
request_token | boolean Default: false Request Token |
notification_url | string Shop URL for failed external authorization or payment |
private | object (OneOfPaymentContainersDTOModelPrivate) Payment instrument data
|
Newly created Payment Container
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "type": "bank_account",
- "private": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051"
}
}
{- "object": "payment.containers",
- "id": "PCT_2Q03MEZ6X2P5BVRXN7FEVTWP0JC2A2",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_3TWY3CJB15IB0R42279EG8SKX9G66E"
}, - "type": "bank_account",
- "private": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "public": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "mandate": {
- "sepa_mandate_id": 692806,
- "type": "CORE",
- "identification": "OTM/A50BL8OR64E86IA06",
- "mandate_date": "2020-03-30T14:52:01+02:00"
}, - "created": "2023-07-10T14:52:01+02:00"
}
Returns the specified Payment Container.
paymentContainerId required | string Example: PCT_RAXFW5O5HHTZL1PJ4QQQJYF2NEJ9AD Payment Container ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Container
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.containers",
- "id": "PCT_2Q03MEZ6X2P5BVRXN7FEVTWP0JC2A2",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_3TWY3CJB15IB0R42279EG8SKX9G66E"
}, - "type": "bank_account",
- "private": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "public": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "mandate": {
- "sepa_mandate_id": 692806,
- "type": "CORE",
- "identification": "OTM/A50BL8OR64E86IA06",
- "mandate_date": "2020-03-30T14:52:01+02:00"
}, - "created": "2023-07-10T14:52:01+02:00"
}
Updates the specified Payment Container with the given data.
paymentContainerId required | string Example: PCT_RAXFW5O5HHTZL1PJ4QQQJYF2NEJ9AD Payment Container ID |
Payment Container properties
merchant_id | string Nullable General Merchant ID |
customer | object Nullable Deprecated The customer the Payment Container belongs to |
customer_id | string Nullable Payment Customer ID |
type | string Container type:
|
request_token | boolean Default: false Request Token |
notification_url | string Shop URL for failed external authorization or payment |
private | object (OneOfPaymentContainersDTOModelPrivate) Payment instrument data
|
Updated Payment Container
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "type": "bank_account",
- "private": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051"
}
}
{- "object": "payment.containers",
- "id": "PCT_2Q03MEZ6X2P5BVRXN7FEVTWP0JC2A2",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_3TWY3CJB15IB0R42279EG8SKX9G66E"
}, - "type": "bank_account",
- "private": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "public": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "mandate": {
- "sepa_mandate_id": 692806,
- "type": "CORE",
- "identification": "OTM/A50BL8OR64E86IA06",
- "mandate_date": "2020-03-30T14:52:01+02:00"
}, - "created": "2023-07-10T14:52:01+02:00",
- "updated": "2023-07-10T14:53:24+02:00"
}
Deletes a Payment Container.
paymentContainerId required | string Example: PCT_RAXFW5O5HHTZL1PJ4QQQJYF2NEJ9AD Payment Container ID |
Deleted Payment Container
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.containers",
- "id": "PCT_2Q03MEZ6X2P5BVRXN7FEVTWP0JC2A2",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_3TWY3CJB15IB0R42279EG8SKX9G66E"
}, - "type": "bank_account",
- "private": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "public": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "mandate": {
- "sepa_mandate_id": 692806,
- "type": "CORE",
- "identification": "OTM/A50BL8OR64E86IA06",
- "mandate_date": "2020-03-30T14:52:01+02:00"
}, - "created": "2023-07-10T14:52:01+02:00"
}
Returns the URL of the B2B mandate form for this Payment Container. The form is a one-page PDF document. It must be signed by an authorised person and then uploaded again.
paymentContainerId required | string Example: PCT_RAXFW5O5HHTZL1PJ4QQQJYF2NEJ9AD Payment Container ID |
B2B mandate form properties
customer_id | string Payment Customer ID the SEPA mandate belongs to |
type | string SEPA mandate type (must be "B2B") |
Mandate form URL
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "customer_id": "PCU_R2K5GTBAR2P5D8S76678M6XS0FYMAJ",
- "type": "B2B"
}
{
}
Processes the signed B2B mandate for this Payment Container. The PDF must have been uploaded shortly before with POST /Document/Uploads. Now it is assigned to the Payment Container and a service case is created to carry out the activation.
paymentContainerId required | string Example: PCT_RAXFW5O5HHTZL1PJ4QQQJYF2NEJ9AD Payment Container ID |
Signed B2B mandate properties
document_id | string Document ID to assign |
Service case number
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "document_id": "DUP_E59X474K1P83O7K516ETYWUBSWDUJB"
}
{- "service_issue_id": 2875433
}
Archive a Payment Container
paymentContainerId required | string Example: PCT_RAXFW5O5HHTZL1PJ4QQQJYF2NEJ9AD Payment Container ID |
Action was successful
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "result": true
}
Processes the Single IBAN Validation
Id and IBAN to validate the input
id | integer Batch reference ID |
iban | string International Bank Account Number (IBAN) |
Id, Validation, IBAN and BIC
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "id": 1,
- "iban": "DE02120300000000202051"
}
{- "id": 1,
- "valid": true,
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}
Payment contracts offer a view to a merchant's contracts, and are used to create payment transactions. S. a. General Contracts.
Returns the Payment Contracts matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Contracts
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 48,
- "data": [
- {
- "object": "general.contracts",
- "id": "GCR_396SQXIC78HXZ3TKL2FN4G9NJ2WJZR",
- "id_old": 1142838,
- "approved": true,
- "created": "2023-09-18T09:47:35+02:00",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_INRCA5MBJF8P1R3LFWOBU2X5KG3SOD"
}
}, - {
- "object": "general.contracts",
- "id": "GCR_DL1PE0E148UUE3LJTQJEBYKCWE5GWH",
- "id_old": 1015883,
- "parent": {
- "object": "general.contracts",
- "id": "GCR_ZET4J6P4G1GA1S79XE2FG33T2SP77J"
}, - "approved": false,
- "created": "2023-09-18T09:47:35+02:00",
- "pay_in_account": {
- "owner": "secupay AG",
- "iban": "DE93968327888562506898",
- "bic": "COBADEFFXXX",
- "bankname": "Commerzbank CC"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_UUWQ85GUVSP6BHTEHPLBDGZ3ASHCB9"
}
}
]
}
Returns the specified Payment Contract.
paymentContractId required | string Example: GCR_396SQXIC78HXZ3TKL2FN4G9NJ2WJZR Payment Contract ID ( |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "general.contracts",
- "id": "GCR_396SQXIC78HXZ3TKL2FN4G9NJ2WJZR",
- "id_old": 1142838,
- "approved": true,
- "created": "2023-09-18T09:47:35+02:00",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_INRCA5MBJF8P1R3LFWOBU2X5KG3SOD"
}
}
Get available payment methods for the Payment Contract for the given ID.
paymentContractId required | string Contract identifier |
Payment methods possible for given contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
[- "string"
]
Clones a contract without identification process. This is used to onboard new projects for known merchants of your platform or marketplace.
paymentContractId required | string Example: GCR_FD6EDRONTEHWBFVTOZE034XBXIIJN4 Payment Contract ID ( |
New Payment Contract
contract_id | string General Contract ID of the parent contract |
project | string Project name (must be unique) |
payment_data | object (PaymentInformation) Bank details |
payin_account | boolean Default: "false" Pay-in account |
url_push | string Default URL for push notifications; this is where your service listens for callbacks of the secuconnect service |
Updated payment contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "project": "Erlebnis-Bauernhof Musterdorf",
- "payout_account": {
- "iban": "DE02120300000000202051",
- "owner": "Musterfirma GmbH"
}
}
{- "object": "general.contracts",
- "id": "GCR_OVSMN0U1XJTW0GWRL9J8WXSLJFGHW3",
- "id_old": 1559238,
- "parent": {
- "object": "general.contracts",
- "id": "GCR_FD6EDRONTEHWBFVTOZE034XBXIIJN4"
}, - "approved": false,
- "created": "2023-09-18T13:18:15+02:00",
- "pay_in_account": {
- "owner": "secupay AG",
- "iban": "DE02600501010002034304",
- "bic": "WELADEDDXXX",
- "bankname": "Landesbank Hessen-Thüringen Girozentrale NL. Düsseldorf"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_ESL82U8E82IU4PG3WRCZ696BWPN5EO"
}, - "apikey": "q32afazxcg7rxln6c289ri56o5xal40r951rylj5"
}
Clones a contract and starts the identification process. This is used to onboard entirely new merchants to your platform or marketplace.
paymentContractId required | string Example: GCR_FD6EDRONTEHWBFVTOZE034XBXIIJN4 Payment Contract ID ( |
Payment contract request id properties
contract_id | string General Contract ID of the parent contract |
contact required | object (Contact) Contact details |
project required | string Project name (must be unique) |
payout_account | object (PaymentInformation) Bank details |
payment_data | object (PaymentInformation) Bank details |
iframe_opts | object (PaymentContractsDTOIFrameOpts) PaymentContractsDTOIFrameOpts |
url_push | string Default URL for push notifications; this is where your service listens for callbacks of the secuconnect service |
payin_account | boolean Default: "false" Pay-in account |
create_first_store | boolean Default: "false" Whether to create a first store at the same location |
store_name | string Store name of the first store |
payout_purpose | string /[^0-9a-zA-Z .,+\-:?()\/\']+/ Purpose for payouts that appears at the bank statement |
identrequest | string Object ID of Services Identrequest ( |
signed_contract | string The document ID of of uploaded signed contract; s. Document service ( |
additional_data | object (PaymentContractsDTORequestIdAdditionalData) Additional data input |
notes | string Additional notes |
invoice_reference | string Reference-Text from Inputfield |
tid | string Third party terminal ID |
merchant_category | integer Merchant category This is not the ISO Merchant Category Code (MCC). The list can be obtained at `GET /pai/v2/General/Merchants/me/MerchantCategories. |
account_statement_text | string Descriptor that appears at the credit card statements |
pricing | Array of objects (PaymentContractsDTORequestIdPricing) Pricing |
funding_threshold | integer Funding Threshold |
funding_end | string Funding End |
project_url | string Project URL |
project_brochure | string Project Brochure |
project_factsheet | string Project Factsheet |
project_duration | integer Project Duration |
account_verification | string Account Verification |
interest_payment_interval | string Interest Payment Interval |
New Payment Contract
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "contact": {
- "salutation": "Mr.",
- "title": "Dr.",
- "forename": "Max",
- "surname": "Mustermann",
- "companyname": "Musterfirma GmbH",
- "dob": "1981-02-03",
- "email": "muster@example.com",
- "phone": "+49 555 5555555",
- "mobile": "+49 170 5555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "1a",
- "postal_code": "09999",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "project": "Erlebnis-Bauernhof Musterdorf",
- "payout_account": {
- "iban": "DE02120300000000202051",
- "owner": "Musterfirma GmbH"
}
}
{- "object": "general.contracts",
- "id": "GCR_OVSMN0U1XJTW0GWRL9J8WXSLJFGHW3",
- "id_old": 1559230,
- "parent": {
- "object": "general.contracts",
- "id": "GCR_FD6EDRONTEHWBFVTOZE034XBXIIJN4"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_ESL82U8E82IU4PG3WRCZ696BWPN5EO"
}, - "approved": false,
- "created": "2023-09-18T13:10:12+02:00",
- "payin_account": {
- "accountowner": "secupay AG",
- "owner": "secupay AG",
- "iban": "DE02600501010002034304",
- "bic": "WELADEDDXXX"
}, - "apikey": "q32afazxcg7rxln6c289ri56o5xal40r951rylj5",
- "contract": {
- "object": "general.contracts",
- "id": "GCR_OVSMN0U1XJTW0GWRL9J8WXSLJFGHW3"
}
}
Revoke accrual flag for all transactions of the specified Payment Contract.
paymentContractId required | string Contract identifier |
Payload accepted, revoke accrual flag is done in background
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "status": "error",
- "error": "ProductUnauthorizedException",
- "error_details": "Invalid token",
- "error_user": "ungültiger Token",
- "code": 0,
- "supportId": "s4l2y7oyr10p7wjtg8o6gnq2esly6r3v"
}
Changes the payout bank account of a contract.
paymentContractId required | string Contract identifier |
iban | string International Bank Account Number (IBAN) |
bic | string Bank Identifier Code (BIC) |
owner | string Account owner name (personal name or company name) |
bankname | string Nullable Bank name |
Returns that the request was successful
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "owner": "Max Mustermann",
- "bankname": "Deutsche Kreditbank Berlin"
}
{- "result": true
}
A convenient way to create a payout transaction. Payouts are payments paid by a merchant and received by his customers. S. a. Payment Transactions.
Returns the specified Payment Secupaypayout.
paymentPayoutId required | string Payment Transaction ID |
Payment Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.secupaypayout",
- "id": "6hbx1e1e9l6997y6mb0b",
- "trans_id": 49999999,
- "status": "pending",
- "amount": 400,
- "currency": "EUR",
- "purpose": "Auszahlung für Erlebnis-Bauernhof Musterdorf",
- "order_id": "12345",
- "transaction_status": 25,
- "transaction_list": [
- {
- "item_type": "transaction_payout",
- "name": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "total": "100",
- "reference_id": "4052",
- "container_id": "PCT_JVF826JNTLEUBHE9DTUJQX5MD8QHTA"
}, - {
- "item_type": "transaction_payout",
- "name": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "total": "300",
- "reference_id": "4053",
- "container_id": "PCT_TX2XESSVVGCZFKK6SFSON342RRI654"
}
], - "transfer_purpose": "TA 49999999",
- "transfer_account": {
- "iban": "DE52906824149239887934",
- "bic": "WELADEDDXXX",
- "accountnumber": "1747013",
- "bankcode": "30050000",
- "account_owner": "secupay AG"
}
}
Creates a new Payment Secupaypayout from the given data. It can be used to start a payout transaction.
This needs an additional Payment Customer. You should prefer POST /Payment/Secupaypayout/me/PayoutWithoutCustomer
.
Payout transaction details
redirect_url | object (SecupayRedirectUrl) SecupayRedirectUrl |
contract | string General Contract ID |
customer | object (PaymentCustomersProductModel) Default: {} Customer details |
opt_data | object Options for customizing the checkout page |
amount | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
currency | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
purpose | string The purpose of the payment. It appears at the bank statement of the payee. |
order_id | string Order number. Depending on the contract setting, it must be unique for each payment. |
transaction_list | Array of objects (SecupayTransactionListItem) Payout items |
Newly created payout transaction
Missing or invalid token
Not logged in or no contract
Payment method not available
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "demo": "0",
- "customer": "PCU_WRPBSDH3W2XB00575EK6AF393XR8AH",
- "amount": 400,
- "currency": "EUR",
- "purpose": "Auszahlung für Erlebnis-Bauernhof Musterdorf",
- "order_id": "12345",
- "opt_data": {
- "language": "en_US"
}, - "transaction_list": [
- {
- "reference_id": "4052",
- "name": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "total": "100",
- "container_id": "PCT_JVF826JNTLEUBHE9DTUJQX5MD8QHTA"
}, - {
- "reference_id": "4053",
- "name": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "total": "300",
- "container_id": "PCT_TX2XESSVVGCZFKK6SFSON342RRI654"
}
]
}
{- "object": "payment.secupaypayout",
- "id": "6hbx1e1e9l6997y6mb0b",
- "trans_id": 49999999,
- "status": "pending",
- "amount": 400,
- "currency": "EUR",
- "purpose": "Payout",
- "order_id": "12345",
- "transaction_status": 25,
- "transaction_list": [
- {
- "item_type": "transaction_payout",
- "name": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "total": "100",
- "reference_id": "4052",
- "container_id": "PCT_JVF826JNTLEUBHE9DTUJQX5MD8QHTA"
}, - {
- "item_type": "transaction_payout",
- "name": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "total": "300",
- "reference_id": "4053",
- "container_id": "PCT_TX2XESSVVGCZFKK6SFSON342RRI654"
}
], - "transfer_purpose": "TA 49999999",
- "transfer_account": {
- "iban": "DE52906824149239887934",
- "bic": "WELADEDDXXX",
- "accountnumber": "1747013",
- "bankcode": "30050000",
- "account_owner": "secupay AG"
}
}
Creates a new Payment Secupaypayout from the given data. It can be used to start a payout transaction.
Payout transaction details
amount | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
currency | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
contract_id | string General Contract ID |
payout_list | Array of objects (SecupayPayoutListItem) Payout items |
purpose | string The purpose of the payment. It appears at the bank statement of the payee. |
execution_date | string Date when the payout should be started (ISO 8601 date, or date and time) |
Newly created payout transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "contract_id": "GCR_8VQ6NM20NHF6PZH1VNHJ7XXBU0QQ34",
- "amount": 300,
- "currency": "EUR",
- "purpose": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "payout_list": [
- {
- "bank_account": {
- "owner": "Max Mustermann",
- "iban": "DE37503240001000000524"
}, - "recipient": "3",
- "purpose": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "amount": 100
}, - {
- "bank_account": {
- "owner": "Marie Mustermann",
- "iban": "AT411100000237571500"
}, - "recipient": "264748",
- "purpose": "Auszahlung für Erlebnis-Bauernhof Musterdorf",
- "amount": 200
}
]
}
{- "amount": 300,
- "currency": "EUR",
- "contract_id": "GCR_8VQ6NM20NHF6PZH1VNHJ7XXBU0QQ34",
- "payout_list": [
- {
- "amount": 100,
- "purpose": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "reference": null,
- "bank_account": {
- "owner": "Max Mustermann",
- "iban": "DE37503240001000000524",
- "bic": "FTSBDEFAXXX",
- "bankname": "ABN AMRO Bank, Frankfurt Branch"
}, - "origin_transaction": null,
- "trans_id": 110024763
}, - {
- "amount": 200,
- "purpose": "Auszahlung von Erlebnis-Bauernhof Musterdorf",
- "reference": null,
- "bank_account": {
- "owner": "Marie Mustermann",
- "iban": "AT411100000237571500",
- "bic": "BKAUATWWXXX",
- "bankname": "UniCredit Bank Austria AG"
}, - "origin_transaction": null,
- "trans_id": 49999999
}
], - "purpose": "Auszahlung für Erlebnis-Bauernhof Musterdorf",
- "trans_id": 49999997,
- "transfer_account": {
- "iban": "DE52906824149239887934",
- "bic": "COBADEFFXXX",
- "accountnumber": "1005523759",
- "bankcode": "85040061",
- "account_owner": "secupay AG"
}
}
Returns the Payment Payout matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Payouts
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 15,
- "data": [
- {
- "date": "2023-06-30T08:41:00+02:00",
- "purpose": "Auszahlung TA-Code 71234567/31 Umsaetze",
- "documents": [
], - "claim_amount": 0,
- "stakeholder_amount": 0,
- "trans_id": 71234567,
- "invoice_amount": -14061,
- "transaction_volume": 1508645,
- "misc_amount": 0,
- "store_name": null,
- "refund_amount": -302100,
- "currency": "EUR",
- "id": "POU_CKIE2HUU8K19YM7GVFY7TC1QZ4TD8U",
- "payout_amount": 1192484
}, - {
- "date": "2023-05-31T08:30:31+02:00",
- "purpose": "Auszahlung TA-Code 69876543/393 Umsaetze",
- "documents": [
], - "claim_amount": 0,
- "stakeholder_amount": 0,
- "trans_id": 69876543,
- "invoice_amount": -45269,
- "transaction_volume": 5360400,
- "misc_amount": 0,
- "store_name": null,
- "refund_amount": 0,
- "currency": "EUR",
- "id": "POU_BIF51V394UIW9NQA9DWY7FVMRVNGNK",
- "payout_amount": 5315131
}
]
}
Returns the specified Payment Payout.
paymentPayoutId required | string Payment Payout ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Payout
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "date": "2023-06-30T08:41:00+02:00",
- "purpose": "Auszahlung TA-Code 71234567/31 Umsaetze",
- "documents": [
], - "claim_amount": 0,
- "stakeholder_amount": 0,
- "trans_id": 71234567,
- "invoice_amount": -14061,
- "transaction_volume": 1508645,
- "misc_amount": 0,
- "store_name": null,
- "refund_amount": -302100,
- "currency": "EUR",
- "id": "POU_CKIE2HUU8K19YM7GVFY7TC1QZ4TD8U",
- "payout_amount": 1192484
}
A Payment Invoices describes an invoice for payment services by secupay. Directly cleared POS payments are not included (s. Cardprocessing Invoices).
Returns the Payment Invoices matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Invoices
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 132,
- "data": [
- {
- "object": "cardprocessing.invoices",
- "id": "POI_C0HKABT933JQYPA84P8B3F48H802OK",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_BVKYGN6MQE3K54X3IS0UIDHG686EKV",
- "type": 46
}, - "store_name": null,
- "id_old": 1999123,
- "tid": "99999999",
- "invoice_number": "29999321",
- "net_amount": 61500,
- "tax_amount": 11685,
- "amount": 73185,
- "currency": "EUR",
- "type": "invoice",
- "created": "2023-09-06T12:00:00+02:00",
- "updated": "2023-09-06T15:14:32+02:00"
}, - {
- "object": "cardprocessing.invoices",
- "id": "POI_LH6P33GY7A2ALTCFQ3M92IFEU3WYTP",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_Y9G8CTVQXGUGPCHDHZLQ0WDB47QFYB",
- "type": 46
}, - "store_name": null,
- "id_old": 1999456,
- "tid": "99999999",
- "invoice_number": "29999654",
- "net_amount": 5244,
- "tax_amount": 996,
- "amount": 6240,
- "currency": "EUR",
- "type": "invoice",
- "created": "2023-08-31T12:00:00+02:00",
- "updated": "2023-09-04T21:22:38+02:00"
}
]
}
Returns the specified Payment Invoice.
paymentInvoiceId required | string Payment invoice id |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Invoice
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "cardprocessing.invoices",
- "id": "POI_C0HKABT933JQYPA84P8B3F48H802OK",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_BVKYGN6MQE3K54X3IS0UIDHG686EKV",
- "type": 46
}, - "store_name": null,
- "id_old": 1999123,
- "tid": "99999999",
- "invoice_number": "29999321",
- "net_amount": 61500,
- "tax_amount": 11685,
- "amount": 73185,
- "currency": "EUR",
- "type": "invoice",
- "created": "2023-09-06T12:00:00+02:00",
- "updated": "2023-09-06T15:14:32+02:00"
}
The Payment Plan holds the plan details for subscriptions derived from it. Such details include, for example, the type of product, billing cycles and tariffs.
Returns the Payment Plans matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Plans
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 23,
- "data": [
- {
- "object": "payment.plans",
- "id": "PLN_9BMNWFV51T3KB4HE4V9OB1GKA7KULW",
- "description": "Basis-Abo Probemonat 1,99 €, danach mtl. 7,99 €",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 199
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 799
}
], - "paypal_plan_id": "P-C19L1VYIQUGZ5AK61Y8WP9IF",
- "payment_methods": [
- "debit",
- "paypal"
], - "status": "active",
- "product_type": "physical",
- "created": "2023-09-18T15:58:37+02:00",
- "updated": "2023-09-18T15:58:37+02:00"
}, - {
- "object": "payment.plans",
- "id": "PLN_PKM0AS06Z8IKB2UXU01TPY5Q0WMDY8",
- "description": "Plus-Abo Probemonat 3,99 €, danach mtl. 14,99 €",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 199
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 799
}
], - "paypal_plan_id": "P-PFNQ3PVRVC4P16W12CUECJ0L",
- "payment_methods": [
- "creditcard",
- "debit",
- "paypal"
], - "status": "active",
- "product_type": "physical",
- "created": "2023-09-18T15:58:37+02:00",
- "updated": "2023-09-18T15:58:37+02:00"
}
]
}
Creates a new Payment Plan from the given data.
Note: Please care to have the PayPal Subscription Plan in sync!
Plan details
description | string <= 50 characters Short description of the subscription plan |
currency | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
paypal_plan_id | string PayPal Subscription Plan ID; needed for PayPal payment |
status | string Status:
|
payment_methods | Array of strings Payment methods:
|
merchant | object (GeneralMerchantsProductModel) Default: {} GeneralMerchantsProductModel |
merchant_id | string General Merchant ID |
billing_cycles | Array of objects (BillingCyclesItem) Billing cycles |
Newly created Payment Plan
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "description": "Basis-Abo Probemonat 1,99 €, danach mtl. 7,99 €",
- "product_type": "physical",
- "merchant": {
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 199
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 799
}
], - "paypal_plan_id": "P-2WIL62NC8CUGMM123KK49OWE",
- "payment_methods": [
- "debit",
- "paypal"
]
}
{- "object": "payment.plans",
- "id": "PLN_PKM0AS06Z8IKB2UXU01TPY5Q0WMDY8",
- "description": "Basis-Abo Probemonat 1,99 €, danach mtl. 7,99 €",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 199
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 799
}
], - "paypal_plan_id": "P-C19L1VYIQUGZ5AK61Y8WP9IF",
- "payment_methods": [
- "debit",
- "paypal"
], - "status": "active",
- "product_type": "physical",
- "created": "2023-09-18T15:58:37+02:00",
- "updated": "2023-09-18T15:58:37+02:00"
}
Returns the specified Payment Plan.
paymentPlanId required | string Payment Plan ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Plan
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.plans",
- "id": "PLN_PKM0AS06Z8IKB2UXU01TPY5Q0WMDY8",
- "description": "Basis-Abo Probemonat 1,99 €, danach mtl. 7,99 €",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 199
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 799
}
], - "paypal_plan_id": "P-C19L1VYIQUGZ5AK61Y8WP9IF",
- "payment_methods": [
- "debit",
- "paypal"
], - "status": "active",
- "product_type": "physical",
- "created": "2023-09-18T15:58:37+02:00",
- "updated": "2023-09-18T15:58:37+02:00"
}
Updates the specified Payment Plan with the given data.
Note: Please keep the PayPal Subscription Plan in sync!
paymentPlanId required | string Payment Plan ID |
Plans details
description | string <= 50 characters Short description of the subscription plan |
currency | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
paypal_plan_id | string PayPal Subscription Plan ID; needed for PayPal payment |
status | string Status:
|
payment_methods | Array of strings Payment methods:
|
merchant | object (GeneralMerchantsProductModel) Default: {} GeneralMerchantsProductModel |
merchant_id | string General Merchant ID |
billing_cycles | Array of objects (BillingCyclesItem) Billing cycles |
Updated Payment Plan
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "description": "Basis-Abo Probemonat 2,99 €, danach mtl. 9,95 €",
- "merchant": {
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 299
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 995
}
], - "paypal_plan_id": "P-2WIL62NC8CUGMM123KK49OWE",
- "payment_methods": [
- "creditcard",
- "debit",
- "paypal"
]
}
{- "object": "payment.plans",
- "id": "PLN_PKM0AS06Z8IKB2UXU01TPY5Q0WMDY8",
- "description": "Basis-Abo Probemonat 2,99 €, danach mtl. 9,95 €",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 299
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 995
}
], - "paypal_plan_id": "P-2WIL62NC8CUGMM123KK49OWE",
- "payment_methods": [
- "creditcard",
- "debit",
- "paypal"
], - "status": "active",
- "product_type": "digital",
- "created": "2023-09-18T16:27:43+02:00",
- "updated": "2023-09-18T16:34:40+02:00"
}
Updates an existing Payment Plan with the given partial data.
Note: Please keep the PayPal Subscription Plan in sync!
paymentPlanId required | string Payment Plan ID |
Plans details
description | string <= 50 characters Short description of the subscription plan |
currency | string (Currency) ^[A-Z]{3}$ Default: "EUR" ISO-4217 alpha-3 currency code |
paypal_plan_id | string PayPal Subscription Plan ID; needed for PayPal payment |
status | string Status:
|
payment_methods | Array of strings Payment methods:
|
merchant | object (GeneralMerchantsProductModel) Default: {} GeneralMerchantsProductModel |
merchant_id | string General Merchant ID |
billing_cycles | Array of objects (BillingCyclesItem) Billing cycles |
Updated Payment Plan
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "description": "Basis-Abo Probemonat 2,99 €, danach mtl. 9,95 €",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 299
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 995
}
]
}
{- "object": "payment.plans",
- "id": "PLN_PKM0AS06Z8IKB2UXU01TPY5Q0WMDY8",
- "description": "Basis-Abo Probemonat 2,99 €, danach mtl. 9,95 €",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_YHBOQLUW0QP5S6WD2EWTKKXAE4PLX5"
}, - "currency": "EUR",
- "billing_cycles": [
- {
- "sequence": 1,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "trial",
- "total_cycles": 1,
- "price": 299
}, - {
- "sequence": 2,
- "interval": {
- "unit": "month",
- "count": 1
}, - "tenure_type": "regular",
- "total_cycles": 0,
- "price": 995
}
], - "paypal_plan_id": "P-2WIL62NC8CUGMM123KK49OWE",
- "payment_methods": [
- "creditcard",
- "debit",
- "paypal"
], - "status": "active",
- "product_type": "digital",
- "created": "2023-09-18T16:27:43+02:00",
- "updated": "2023-09-18T16:34:40+02:00"
}
The payment subscription controls the payments for a specific subscription. It is created with a Smart Transaction and is derived from, and is connected to, a Subscription Plan. If the original payment instrument no longer works, it can be re-authorised with a Smart Transaction.
Returns the Payment Subscriptions matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Payment Subscriptions
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 567,
- "data": [
- {
- "object": "payment.subscriptions",
- "id": "SUB_QCQ7EST28E9WT89LPL5TBXKQ8ZPM36I0",
- "smart_transaction": {
- "object": "smart.transactions",
- "id": "STX_C6RD4S7BK2P877TR6BDJ9KAHG5H5A5"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_P1MHXFBR0UI997T550QA3X66SMJGW2DM"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_W5IQROAH4NJ674AXBGCGGO3GQBLDB6V0"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_132DIAP07UIUWJ6Q4KZYNKXUXVEUPQOD"
}, - "container": {
- "object": "payment.containers",
- "id": "PCT_UPWULOLKPRSF35BWK0K45Y29WCHVTPE8",
- "type": "paypal"
}, - "plan": {
- "object": "payment.plans",
- "id": "PLN_1B2JJQFJYWB834KXIT77QHY66W9TJ2NT"
}, - "start_at": "2023-09-17T21:03:33+02:00",
- "status": "active",
- "paypal_subscription_id": "I-0TB4QR6UIQ7T",
- "billing_info": {
- "cycle_executions": [
- {
- "sequence": 1,
- "tenure_type": "trial",
- "total_cycles": 1,
- "cycles_completed": 1,
- "cycles_remaining": 0
}, - {
- "sequence": 2,
- "tenure_type": "regular",
- "total_cycles": 0,
- "cycles_completed": 0,
- "cycles_remaining": 0
}
], - "next_billing_time": "2023-10-17T12:00:00+02:00"
}, - "created": "2023-09-17T20:03:37+02:00",
- "updated": "2023-09-17T20:04:39+02:00",
- "demo": false
}, - {
- "object": "payment.subscriptions",
- "id": "SUB_B2OPCVMD6PL7FGXQC087PYJIQ93KRY2A",
- "smart_transaction": {
- "object": "smart.transactions",
- "id": "STX_R7RXTRWW0W7FE9X8CX403HBOZVAL03H7"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_P1MHXFBR0UI997T550QA3X66SMJGW2DM"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_W5IQROAH4NJ674AXBGCGGO3GQBLDB6V0"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_BYK9J7Q7T86E8C3Q396WX5BAI3M9L7M9"
}, - "container": {
- "object": "payment.containers",
- "id": "PCT_8XP6I5JG5JS48OE2GQBNSFPO2ZW54AS8",
- "type": "paypal"
}, - "plan": {
- "object": "payment.plans",
- "id": "PLN_N28D1I7FIYF7WJSN9LI3NCU0RWPSKYKX"
}, - "start_at": "2023-09-16T13:54:33+02:00",
- "status": "active",
- "paypal_subscription_id": "I-1QX3B71AXUR9",
- "billing_info": {
- "cycle_executions": [
- {
- "sequence": 1,
- "tenure_type": "trial",
- "total_cycles": 1,
- "cycles_completed": 1,
- "cycles_remaining": 0
}, - {
- "sequence": 2,
- "tenure_type": "regular",
- "total_cycles": 0,
- "cycles_completed": 0,
- "cycles_remaining": 0
}
], - "next_billing_time": "2023-10-16T12:00:00+02:00"
}, - "created": "2023-09-16T12:54:37+02:00",
- "updated": "2023-09-16T12:55:31+02:00",
- "demo": false
}
]
}
Returns the specified Payment Subscription.
paymentSubscriptionId required | string Payment Subscription ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Payment Subscription
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "payment.subscriptions",
- "id": "SUB_QCQ7EST28E9WT89LPL5TBXKQ8ZPM36I0",
- "smart_transaction": {
- "object": "smart.transactions",
- "id": "STX_C6RD4S7BK2P877TR6BDJ9KAHG5H5A5"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_P1MHXFBR0UI997T550QA3X66SMJGW2DM"
}, - "contract": {
- "object": "general.contracts",
- "id": "GCR_W5IQROAH4NJ674AXBGCGGO3GQBLDB6V0"
}, - "customer": {
- "object": "payment.customers",
- "id": "PCU_132DIAP07UIUWJ6Q4KZYNKXUXVEUPQOD"
}, - "container": {
- "object": "payment.containers",
- "id": "PCT_UPWULOLKPRSF35BWK0K45Y29WCHVTPE8",
- "type": "paypal"
}, - "plan": {
- "object": "payment.plans",
- "id": "PLN_1B2JJQFJYWB834KXIT77QHY66W9TJ2NT"
}, - "start_at": "2023-09-17T21:03:33+02:00",
- "status": "active",
- "paypal_subscription_id": "I-0TB4QR6UIQ7T",
- "billing_info": {
- "cycle_executions": [
- {
- "sequence": 1,
- "tenure_type": "trial",
- "total_cycles": 1,
- "cycles_completed": 1,
- "cycles_remaining": 0
}, - {
- "sequence": 2,
- "tenure_type": "regular",
- "total_cycles": 0,
- "cycles_completed": 0,
- "cycles_remaining": 0
}
], - "next_billing_time": "2023-10-17T12:00:00+02:00"
}, - "created": "2023-09-17T20:03:37+02:00",
- "updated": "2023-09-17T20:04:39+02:00",
- "demo": false
}
A loyalty transaction can be a charge of monetary credit or bonus credit, which can be spent (discharge) in another transaction. Furthermore loyalty transactions track revenues related to loyalty programmes.
Returns the Loyalty Transactions matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Loyalty Transactions
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 103,
- "data": [
- {
- "object": "loyalty.transactions",
- "id": "LTX_9FDWJ2TERFBUV2MVFIID9FOGONTJ4V",
- "trans_id": 34567890,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_K09E2O2G5VMYBCJWFQ6URXCZE2EWVA"
}, - "store": {
- "object": "general.stores",
- "id": "STO_92CDTWDRX46ZNS32A9GGD9F15N31XU",
- "name": "Demo-Store",
- "name_raw": "Demo-Store"
}, - "tid": "VT003456",
- "card": {
- "object": "loyalty.cards",
- "id": "CRD_GX9Z2EN8W6AC2IZKTLQYOGV9CJ4FOE",
- "cardnumber": "9276012345678901"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_MPFEPXDM0ER1TXMJDXDH905Z80DXKX",
- "display_name": "Geschenkkarte",
- "stock_warn_limit": 0
}, - "merchantcard": {
- "object": "loyalty.merchantcards",
- "id": "MCD_15RG7AP074JI239QKEGOI19LZOYYNR"
}, - "currency": "EUR",
- "balance": 1000,
- "amount": 1000,
- "status": "accepted",
- "description": "Aufladung",
- "parents": [ ],
- "children": [ ],
- "created": "2021-08-20T10:19:00+02:00",
- "last_change": "2021-08-20T10:19:00+02:00",
- "is_cancelling": 0,
- "receipt": {
- "header": [
- {
- "type": "space"
}
], - "body": [
- {
- "type": "separator",
- "value": {
- "caption": "Kundenkarte Aufladung"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Terminal-ID:",
- "value": "VT003456",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "20.08.2021 10:19:01",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Kartennummer:",
- "value": "9276012345678901",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "TA Code:",
- "value": "34567890",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Folgender Betrag",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "wurde aufgeladen:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "10,00 EUR",
- "decoration": [
- "important"
]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Aktuelles Guthaben:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "10,00 EUR",
- "decoration": [
- "important"
]
}
}
]
}, - "additional_data": {
- "custom_fields": null
}
}
]
}
Returns the specified Loyalty Transaction.
loyaltyTransactionId required | string Loyalty Transaction ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Loyalty Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.transactions",
- "id": "LTX_9FDWJ2TERFBUV2MVFIID9FOGONTJ4V",
- "trans_id": 34567890,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_K09E2O2G5VMYBCJWFQ6URXCZE2EWVA"
}, - "store": {
- "object": "general.stores",
- "id": "STO_92CDTWDRX46ZNS32A9GGD9F15N31XU",
- "name": "Demo-Store",
- "name_raw": "Demo-Store"
}, - "tid": "VT003456",
- "card": {
- "object": "loyalty.cards",
- "id": "CRD_GX9Z2EN8W6AC2IZKTLQYOGV9CJ4FOE",
- "cardnumber": "9276012345678901"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_MPFEPXDM0ER1TXMJDXDH905Z80DXKX",
- "display_name": "Geschenkkarte",
- "stock_warn_limit": 0
}, - "merchantcard": {
- "object": "loyalty.merchantcards",
- "id": "MCD_15RG7AP074JI239QKEGOI19LZOYYNR"
}, - "currency": "EUR",
- "balance": 1000,
- "amount": 1000,
- "status": "accepted",
- "description": "Aufladung",
- "parents": [ ],
- "children": [ ],
- "created": "2021-08-20T10:19:00+02:00",
- "last_change": "2021-08-20T10:19:00+02:00",
- "is_cancelling": 0,
- "receipt": {
- "header": [
- {
- "type": "space"
}
], - "body": [
- {
- "type": "separator",
- "value": {
- "caption": "Kundenkarte Aufladung"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Terminal-ID:",
- "value": "VT003456",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "20.08.2021 10:19:01",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Kartennummer:",
- "value": "9276012345678901",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "TA Code:",
- "value": "34567890",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Folgender Betrag",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "wurde aufgeladen:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "10,00 EUR",
- "decoration": [
- "important"
]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Aktuelles Guthaben:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "10,00 EUR",
- "decoration": [
- "important"
]
}
}
]
}, - "additional_data": {
- "custom_fields": null
}
}
A Loyalty Customer holds the customer details for a Loyalty Card used as customer card. It can be created and associated with the card at a later point in time, for instance in combination with changing the Loyalty Card Group.
Returns the Loyalty Customers matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Loyalty Customers
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 2,
- "data": [
- {
- "object": "loyalty.customers",
- "id": "CUS_TBASD3CC162O4H792AELTJDDJZI45T",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U"
}, - "merchant_contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "m.mustermann@example.com"
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "m.mustermann@example.com"
}, - "created": "2024-02-23T17:51:57+01:00",
- "consent_for_communication": "declined"
}, - {
- "object": "loyalty.customers",
- "id": "CUS_GGCQX7M3D6VL2AM7VVLMJ1RDITHY7T",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U"
}, - "merchant_contact": {
- "name": "Monika Musterling",
- "forename": "Monika",
- "surname": "Musterling",
- "email": "m.musterling@example.net",
- "address": {
- "street": "Musterstraße",
- "street_number": "17 b",
- "additional_address_data": null,
- "postal_code": "09002",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "contact": {
- "name": "Monika Musterling",
- "forename": "Monika",
- "surname": "Musterling",
- "email": "m.musterling@example.net",
- "address": {
- "street": "Musterstraße",
- "street_number": "17 b",
- "additional_address_data": null,
- "postal_code": "09002",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2024-02-23T17:42:20+01:00",
- "consent_for_communication": "accepted"
}
]
}
Creates a new Loyalty Customer using the given data.
Loyalty Customer details
merchant | string Merchant ID |
merchant_contact | object (Contact) Contact details |
customernumber | string Customer number in the merchant's system |
note | string Note from the merchant |
consent_for_communication | string Whether the customer has given consent for communication or not:
|
additional_data | object Additional data properties |
anonymize | boolean Nullable Anonymize customer data (only valid on update requests) |
Newly created Loyalty Customer
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U",
- "merchant_contact": {
- "forename": "Monika",
- "surname": "Mustermann",
- "email": "m.mustermann@example.net",
- "address": {
- "street": "Musterplatz",
- "street_number": "7",
- "city": "Musterstadt",
- "postal_code": "09001",
- "country": "DE"
}
}, - "consent_for_communication": "accepted"
}
{- "object": "loyalty.customers",
- "id": "CUS_GGCQX7M3D6VL2AM7VVLMJ1RDITHY7T",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U"
}, - "merchant_contact": {
- "name": "Monika Mustermann",
- "forename": "Monika",
- "surname": "Mustermann",
- "email": "m.mustermann@example.net",
- "address": {
- "street": "Musterplatz",
- "street_number": "7",
- "additional_address_data": null,
- "postal_code": "09001",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "contact": {
- "name": "Monika Mustermann",
- "forename": "Monika",
- "surname": "Mustermann",
- "email": "m.mustermann@example.net",
- "address": {
- "street": "Musterplatz",
- "street_number": "7",
- "additional_address_data": null,
- "postal_code": "09001",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2024-02-23T17:42:20+01:00",
- "consent_for_communication": "accepted"
}
Returns the specified Loyalty Customer.
loyaltyCustomerId required | string Loyalty Customer ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Loyalty Customer
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.customers",
- "id": "CUS_GGCQX7M3D6VL2AM7VVLMJ1RDITHY7T",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U"
}, - "merchant_contact": {
- "name": "Monika Mustermann",
- "forename": "Monika",
- "surname": "Mustermann",
- "email": "m.mustermann@example.net",
- "address": {
- "street": "Musterplatz",
- "street_number": "7",
- "additional_address_data": null,
- "postal_code": "09001",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "contact": {
- "name": "Monika Mustermann",
- "forename": "Monika",
- "surname": "Mustermann",
- "email": "m.mustermann@example.net",
- "address": {
- "street": "Musterplatz",
- "street_number": "7",
- "additional_address_data": null,
- "postal_code": "09001",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2024-02-23T17:54:45+01:00",
- "consent_for_communication": "accepted"
}
Updates the specified Loyalty Customer using the given data.
loyaltyCustomerId required | string Loyalty Customer ID |
Loyalty Customer details
merchant | string Merchant ID |
merchant_contact | object (Contact) Contact details |
customernumber | string Customer number in the merchant's system |
note | string Note from the merchant |
consent_for_communication | string Whether the customer has given consent for communication or not:
|
additional_data | object Additional data properties |
anonymize | boolean Nullable Anonymize customer data (only valid on update requests) |
Updated Loyalty Customer
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant_contact": {
- "forename": "Monika",
- "surname": "Musterling",
- "email": "m.musterling@example.net",
- "address": {
- "street": "Musterstraße",
- "street_number": "17 b",
- "city": "Musterstadt",
- "postal_code": "09002",
- "country": "DE"
}
}, - "consent_for_communication": "accepted"
}
{- "object": "loyalty.customers",
- "id": "CUS_GGCQX7M3D6VL2AM7VVLMJ1RDITHY7T",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U"
}, - "merchant_contact": {
- "name": "Monika Musterling",
- "forename": "Monika",
- "surname": "Musterling",
- "email": "m.musterling@example.net",
- "address": {
- "street": "Musterstraße",
- "street_number": "17 b",
- "additional_address_data": null,
- "postal_code": "09002",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "contact": {
- "name": "Monika Musterling",
- "forename": "Monika",
- "surname": "Musterling",
- "email": "m.musterling@example.net",
- "address": {
- "street": "Musterstraße",
- "street_number": "17 b",
- "additional_address_data": null,
- "postal_code": "09002",
- "city": "Musterstadt",
- "country": "DE"
}
}, - "created": "2024-02-23T17:42:20+01:00",
- "consent_for_communication": "accepted"
}
Assigns the specified Loyalty Payment Container to the specified Loyalty Customer.
loyaltyCustomerId required | string Loyalty Customer ID |
loyaltyPaymentContainerId required | string Loyalty Payment Container ID |
Updated Loyalty Customer
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.customers",
- "id": "CUS_TBASD3CC162O4H792AELTJDDJZI45T",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U"
}, - "payment_container": [
- {
- "object": "loyalty.paymentcontainers",
- "id": "LPC_W3HUXJ5EP2PESYNSTKUF60JKGDNCAZ",
- "type": "bank_account",
- "payment_information": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}, - "last_usage": null
}
], - "merchant_contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "m.mustermann@example.com"
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "m.mustermann@example.com"
}, - "created": "2024-02-26T11:13:09+01:00",
- "consent_for_communication": "declined"
}
Detaches the specified Loyalty Payment Container from the specified Loyalty Customer.
loyaltyCustomerId required | string Loyalty Customer ID |
loyaltyPaymentContainerId required | string Loyalty Payment Container ID |
Updated Loyalty Customer
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.customers",
- "id": "CUS_TBASD3CC162O4H792AELTJDDJZI45T",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FVIOF8INPJODEQS14B9AAIVBSQI59U"
}, - "merchant_contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "m.mustermann@example.com"
}, - "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "email": "m.mustermann@example.com"
}, - "created": "2024-02-26T11:13:09+01:00",
- "consent_for_communication": "declined"
}
Loyalty Cards represent physical or virtual secucard cards, identified by their card numbers. This is the card holder's view on the card.
Each secucard card can be used for one or more merchants. The merchant's perspective is covered by the associated Merchant Cards (see there).
Returns the Loyalty Cards matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Loyalty Cards
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 1234567,
- "data": [
- {
- "object": "loyalty.cards",
- "id": "CRD_M4SBA579N0JHDJGAFJ229PZJO0I243",
- "cardnumber": "9276001234567890",
- "account": {
- "object": "general.accounts",
- "id": "ACC_N1MAINPB8KSMPNNVSG74LZNUQRHYUS"
}, - "created": "2021-11-30T16:33:50+01:00"
}, - {
- "object": "loyalty.cards",
- "id": "CRD_Z3ZOUXFLLVSLIEX6WV71UA6CT3XWVZ",
- "cardnumber": "9276001234567891",
- "created": "2021-11-30T16:33:48+01:00"
}
]
}
Returns the specified Loyalty Card.
loyaltyCardId required | string Search one loyalty card by provided id |
expand | string Example: expand=true Expand fields (all or a specific one) |
Loyalty Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.cards",
- "id": "CRD_M4SBA579N0JHDJGAFJ229PZJO0I243",
- "cardnumber": "9276001234567891",
- "account": {
- "object": "general.accounts",
- "id": "ACC_N1MAINPB8KSMPNNVSG74LZNUQRHYUS"
}, - "created": "2021-11-30T16:33:50+01:00"
}
Assigns the specified Loyalty Card to the specified General Account.
loyaltyCardId required | string Loyalty Card ID |
generalAccountId required | string General Account ID |
Card PIN of the specific Loyalty Card
pin | string Card PIN (four decimal digits) The card PIN must not be mixed with the Card Security Code (CSC) on the card. |
Whether it was successfully assigned
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "pin": "9867"
}
{- "result": true
}
Detaches the specified Loyalty Card from the specified General Account.
loyaltyCardId required | string Loyalty Card ID |
generalAccountId required | string General Account ID |
Whether it was successfully detached
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "result": true
}
Card Groups define different loyalty programmes offered by a merchant. Every Merchant Card can be assigned to only one Card Group at a time. But the Card Group can be changed, for instance to lift a customer card on a higher level. The card balances are then taken unchanged to the new programme.
Returns the Loyalty Card Groups matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Loyalty Card Groups
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 21,
- "data": [
- {
- "object": "loyalty.cardgroups",
- "id": "CRG_0G2Z22NQALPYKZD88XQ7723G78B9HU",
- "display_name": "Geschenkkarte",
- "display_name_raw": "Geschenkkarte",
- "stock_warn_limit": 0,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_S2WN3JRQH4DPSBN5DD548GVD7A5NQF"
}, - "balance_limit": 10000,
- "balance_expiry": true,
- "cancel_selected": false,
- "description": null
}, - {
- "object": "loyalty.cardgroups",
- "id": "CRG_AXKDG8WIYNQNBHED5NZ7LVUFHNZYAV",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_S2WN3JRQH4DPSBN5DD548GVD7A5NQF"
}, - "balance_limit": 20000,
- "balance_expiry": false,
- "cancel_selected": true,
- "description": null
}
]
}
Creates a new Loyalty Cardgroup using the given data.
Loyalty Card Group details
display_name required | string Display name (programme name) |
picture | string Nullable Document Upload ID of symbol image |
merchant required | string General Merchant ID |
Newly created Loyalty Card Group
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "display_name": "Geschenkkarte",
- "picture": "DUP_FJFV41MV78Y1VLS9CNQQ04LKJCDHVZ",
- "merchant": "MRC_S2WN3JRQH4DPSBN5DD548GVD7A5NQF"
}
{- "object": "loyalty.cardgroups",
- "id": "CRG_6XWQO0DNJXFECCYFNXFWRWDUAB69UD",
- "display_name": "Geschenkkarte",
- "display_name_raw": "Geschenkkarte",
- "stock_warn_limit": 0,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_S2WN3JRQH4DPSBN5DD548GVD7A5NQF"
}, - "balance_limit": 2000000,
- "balance_expiry": false,
- "cancel_selected": false,
- "description": null
}
Returns the specified Loyalty Card Group.
loyaltyCardGroupId required | string Loyalty Card Group ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Loyalty Card Group
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.cardgroups",
- "id": "CRG_6XWQO0DNJXFECCYFNXFWRWDUAB69UD",
- "display_name": "Geschenkkarte",
- "display_name_raw": "Geschenkkarte",
- "stock_warn_limit": 0,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_S2WN3JRQH4DPSBN5DD548GVD7A5NQF"
}, - "balance_limit": 2000000,
- "balance_expiry": false,
- "cancel_selected": false,
- "description": null
}
Updates the specified Loyalty Card Group using the given data.
loyaltyCardGroupId required | string Loyalty Card Group ID |
Loyalty Card Group details
display_name required | string Display name (programme name) |
picture | string Nullable Document Upload ID of symbol image |
Updated Loyalty Card Group
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "display_name": "Geschenkkarte",
- "picture": "DUP_GX7UBYOZUBUPHV8R271D3UQLOSHKIE"
}
{- "object": "loyalty.cardgroups",
- "id": "CRG_6XWQO0DNJXFECCYFNXFWRWDUAB69UD",
- "display_name": "Geschenkkarte",
- "display_name_raw": "Geschenkkarte",
- "stock_warn_limit": 0,
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_S2WN3JRQH4DPSBN5DD548GVD7A5NQF"
}, - "balance_limit": 2000000,
- "balance_expiry": false,
- "cancel_selected": false,
- "description": null
}
Checks whether the passcode check is enabled, and therefore required, for a specific action.
loyaltyCardGroupId required | string Loyalty Card Group ID |
Check passcode details
action | string Action type:
|
cardnumber | string Loyalty card number |
Whether passcode is needed (true
) or not (false
)
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "action": "charge",
- "cardnumber": "9276001234567890"
}
{- "result": true
}
A Loyalty Merchant Card is a per-merchant view on a Loyalty Card. So you can use one card for more multiple merchants with separate accounting.
The card can have two different forms of balance at the same time, monetary credit and bonus balance, one for money paid in and the other as reward for revenues. They have different origins and must be handled differently in book-keeping. When spent they make no difference.
A card can be secured by either the card security code (CSC) printed on card, or a configurable passcode. Please don't mix them up!
Returns the Loyalty Merchant Cards matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Loyalty Merchant Cards
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 104,
- "data": [
- {
- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "9276001234567890",
- "created": "2021-11-30T14:48:56+01:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "payment_container": {
- "object": "loyalty.paymentcontainers",
- "id": "LPC_GZI08RBBLUA4MI3JT079PTW04LPJHI",
- "type": "bank_account",
- "payment_information": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}
}, - "is_base_card": true,
- "points": 0,
- "cash_balance": 1500,
- "bonus_balance": 0,
- "balance": 1500,
- "last_usage": "2021-11-30T14:48:57+01:00",
- "last_charge": "2021-11-30T14:48:57+01:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null,
- "customer_assignment_date": null
}
]
}
Returns the specified Loyalty Merchant Card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Loyalty Merchant Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "927600134567890",
- "created": "2021-08-26T13:44:05+02:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "payment_container": {
- "object": "loyalty.paymentcontainers",
- "id": "LPC_GZI08RBBLUA4MI3JT079PTW04LPJHI",
- "type": "bank_account",
- "payment_information": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}
}, - "is_base_card": true,
- "points": 0,
- "cash_balance": 1000,
- "bonus_balance": 0,
- "balance": 1000,
- "last_usage": "2021-08-26T13:44:05+02:00",
- "last_charge": "2021-08-26T13:44:05+02:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null
}
Updates the specified Loyalty Merchant Card with the given data.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Merchant Card details
expiry_date | string Expiry date in RFC3339 format |
payment_container | string Loyalty Payment Container ID |
additional_data | object Custom additional data |
Updated Loyalty Merchant Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "payment_container": "LPC_GZI08RBBLUA4MI3JT079PTW04LPJHI"
}
{- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "927600134567890",
- "created": "2021-08-26T13:44:05+02:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "payment_container": {
- "object": "loyalty.paymentcontainers",
- "id": "LPC_GZI08RBBLUA4MI3JT079PTW04LPJHI",
- "type": "bank_account",
- "payment_information": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}
}, - "is_base_card": true,
- "points": 0,
- "cash_balance": 1000,
- "bonus_balance": 0,
- "balance": 1000,
- "last_usage": "2021-08-26T13:44:05+02:00",
- "last_charge": "2021-08-26T13:44:05+02:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null
}
Sets the Loyalty Card Group, and returns the updated Loyalty Merchant Card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
loyaltyCardGroupId required | string Loyalty Card Group ID |
Updated Loyalty Merchant Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "927600134567890",
- "created": "2021-08-26T13:44:05+02:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_X9TJZ09PCHL137JZ71ANGHOEKA3LFW",
- "display_name": "Kundenkarte Premium",
- "display_name_raw": "Kundenkarte Premium",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "payment_container": {
- "object": "loyalty.paymentcontainers",
- "id": "LPC_GZI08RBBLUA4MI3JT079PTW04LPJHI",
- "type": "bank_account",
- "payment_information": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}
}, - "is_base_card": true,
- "points": 0,
- "cash_balance": 1000,
- "bonus_balance": 0,
- "balance": 1000,
- "last_usage": "2021-08-26T13:44:05+02:00",
- "last_charge": "2021-08-26T13:44:05+02:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null
}
Creates a new Loyalty Customer, and assigns it to the specified Loyalty Merchant Card.
This can only be done once per Merchant Card. But you can update it using the Loyalty Customer operations.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Loyalty Customer details
merchant | string Merchant ID |
merchant_contact | object (Contact) Contact details |
customernumber | string Customer number in the merchant's system |
note | string Note from the merchant |
consent_for_communication | string Whether the customer has given consent for communication or not:
|
additional_data | object Additional data properties |
anonymize | boolean Nullable Anonymize customer data (only valid on update requests) |
Updated Loyalty Merchant Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO",
- "merchant_contact": {
- "forename": "Max",
- "surname": "Mustermann",
- "email": "m.mustermann@example.com",
- "mobile": "+49 155 5555555",
- "dob": "1975-05-25T00:00:00+00:00",
- "nationality": "DE"
}, - "customernumber": "K765",
- "consent_for_communication": "accepted"
}
{- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "9276001324567890",
- "created": "2021-08-25T11:45:16+02:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "customer": {
- "object": "loyalty.customers",
- "id": "CUS_NJ8L6688IXQJVXUN07W4FT4AV4TZSG",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "dob": "1975-05-25T00:00:00+00:00",
- "nationality": "DE",
- "email": "m.mustermann@example.com",
- "mobile": "+491555555555"
}, - "created": "2024-03-15T09:46:47+01:00",
- "consent_for_communication": "accepted"
}, - "customer_assignment_date": "2024-03-15T09:46:47+01:00",
- "is_base_card": true,
- "points": 0,
- "cash_balance": 1000,
- "bonus_balance": 0,
- "balance": 1000,
- "last_usage": "2021-08-25T11:45:17+02:00",
- "last_charge": "2021-08-25T11:45:17+02:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null
}
Assigns an existing Loyalty Customer to the specified Loyalty Merchant Card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
loyaltyCustomerId required | string Loyalty Customer ID |
Updated Loyalty Merchant Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "9276001324567890",
- "created": "2021-08-25T11:45:16+02:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "customer": {
- "object": "loyalty.customers",
- "id": "CUS_NJ8L6688IXQJVXUN07W4FT4AV4TZSG",
- "contact": {
- "name": "Max Mustermann",
- "forename": "Max",
- "surname": "Mustermann",
- "dob": "1975-05-25T00:00:00+00:00",
- "nationality": "DE",
- "email": "m.mustermann@example.com",
- "mobile": "+491555555555"
}, - "created": "2024-03-15T09:46:47+01:00",
- "consent_for_communication": "accepted"
}, - "customer_assignment_date": "2024-03-15T09:46:47+01:00",
- "is_base_card": true,
- "points": 0,
- "cash_balance": 1000,
- "bonus_balance": 0,
- "balance": 1000,
- "last_usage": "2021-08-25T11:45:17+02:00",
- "last_charge": "2021-08-25T11:45:17+02:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null
}
Returns the lock reasons.
Lock reasons
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
[- {
- "id": 1,
- "desc": "Diebstahl/Verlust"
}, - {
- "id": 2,
- "desc": "Defekt"
}, - {
- "id": 3,
- "desc": "offene Forderungen"
}, - {
- "id": 4,
- "desc": "unbekannt"
}, - {
- "id": 5,
- "desc": "Datenübernahme"
}, - {
- "id": 6,
- "desc": "Karte abgelaufen"
}, - {
- "id": 7,
- "desc": "Rücklastschrift"
}, - {
- "id": 8,
- "desc": "nicht Freigeschalten"
}, - {
- "id": 9,
- "desc": "Sperrung durch Karteninhaber"
}, - {
- "id": 10,
- "desc": "auto. Eintrag nach TA-Störung"
}, - {
- "id": 11,
- "desc": "Ausfallquote > Grenzwert"
}
]
Returns the lock details of the specified Loyalty Merchant Card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Lock details
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "lock_status": "locked",
- "reason": 1,
- "note": "Anruf von Herrn M., Karte verloren"
}
Locks the specified Loyalty Merchant Card, so that it cannot be used.
Works only for Merchant Cards not being locked.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Lock details
reason | integer Lock reason:
|
note | string Human readable note |
csc | string Card Security Code (optional in the most cases) |
Updated Loyalty Merchant Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "reason": 1,
- "note": "Anruf von Herrn M., Karte verloren"
}
{- "object": "loyalty.merchantcards",
- "id": "MCD_F2FLOVCAUGH1EA36C1SK7KIXO0VT6W",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_G3RNQEYID5FIXFRLX9HIL5KT684XDC"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_G3RNQEYID5FIXFRLX9HIL5KT684XDC"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_T82UNIW9PX04EZCD4OUJSYWH39OAYG",
- "cardnumber": "9276001234567890",
- "created": "2021-08-26T13:44:05+02:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_V31WQ6HWXY1WK47A911M73GZYYRZ3D",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_9COFQWATLGJ0VHM8T27KSC8BFW14ZA"
}, - "payment_container": {
- "object": "loyalty.paymentcontainers",
- "id": "LPC_O733Z2FHNRFYXC2GAQSPDLWLUBFKB5",
- "type": "bank_account",
- "payment_information": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}
}, - "is_base_card": true,
- "points": 0,
- "cash_balance": 1000,
- "bonus_balance": 0,
- "balance": 1000,
- "last_usage": "2021-08-26T13:44:05+02:00",
- "last_charge": "2021-08-26T13:44:05+02:00",
- "stock_status": "active",
- "lock_status": "locked",
- "passcode": 1,
- "expiry_date": null
}
Unlocks the specified Loyalty Merchant Card, so that it can be used again.
Works only for Merchant Cards being locked.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Unlock details
reason | integer Lock reason:
|
note | string Human readable note |
csc | string Card Security Code (optional in the most cases) |
Updated Loyalty Merchant Card
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "note": "Anruf von Frau M., Kartenaktivierung"
}
{- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "927600134567890",
- "created": "2021-08-26T13:44:05+02:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "payment_container": {
- "object": "loyalty.paymentcontainers",
- "id": "LPC_GZI08RBBLUA4MI3JT079PTW04LPJHI",
- "type": "bank_account",
- "payment_information": {
- "owner": "Max Mustermann",
- "iban": "DE02120300000000202051",
- "bic": "BYLADEM1001",
- "bankname": "Deutsche Kreditbank Berlin"
}
}, - "is_base_card": true,
- "points": 0,
- "cash_balance": 1000,
- "bonus_balance": 0,
- "balance": 1000,
- "last_usage": "2021-08-26T13:44:05+02:00",
- "last_charge": "2021-08-26T13:44:05+02:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null
}
Returns the virtual terminal data for the merchant.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
loyaltyMerchantId required | string Loyalty Merchant ID |
Virtual terminal details
Disabled
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "disabled": 1
}
Carries out a Loyalty Transaction. Intended to be used by SDK
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
targetMerchantCardId required | string Loyalty Merchant Card ID |
Transaction details
action | string Action:
|
terminal_id | string Terminal ID |
amount | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
tid | string Terminal TID |
store | string General Store ID |
cardnumber | string Number on card |
bonus_amount | integer Bonus amount |
amount_split_allowed | string Whether amount split is allowed |
merchant_id | string General Merchant ID |
additional_data | object |
Merchant Card details incl. receipt
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "action": "charge",
- "amount": 100,
- "bonus_amount": 100,
- "tid": "VT003456"
}
{- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "9276001234657890",
- "created": "2023-03-14T14:46:10+01:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "customer": {
- "object": "loyalty.customers",
- "id": "CUS_NJ8L6688IXQJVXUN07W4FT4AV4TZSG",
- "contact": {
- "email": "max@example.net"
}, - "created": "2023-03-14T14:46:10+01:00",
- "consent_for_communication": "accepted"
}, - "customer_assignment_date": "2023-03-14T14:46:10+01:00",
- "is_base_card": true,
- "points": 0,
- "cash_balance": 7600,
- "bonus_balance": 0,
- "balance": 7600,
- "last_usage": "2023-03-16T16:02:59+01:00",
- "last_charge": "2023-03-16T16:02:59+01:00",
- "stock_status": "active",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null,
- "receipt_header": [
- {
- "type": "space"
}
], - "receipt": [
- {
- "type": "separator",
- "value": {
- "caption": "Kundenkarte Aufladung"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Terminal-ID:",
- "value": "VT003456",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "16.03.2023 16:02:59",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Kartennummer:",
- "value": "9276001234567890",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "TA Code:",
- "value": "234567890",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Folgender Betrag",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "wurde aufgeladen:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "1,00 EUR",
- "decoration": [
- "important"
]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Aktuelles Guthaben:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "76,00 EUR",
- "decoration": [
- "important"
]
}
}
], - "trans_id": 234567890,
- "amount": 100
}
Checks the Card Security Code (CSC).
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Card number and security code
cardnumber | string Number on card |
csc | string Entered Card Security Code |
Whether the CSC is good (true
) or not (false
)
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "cardnumber": 9276001234567890,
- "csc": "3645"
}
{- "result": true
}
Returns whether it is a Merchant Card for the given Merchant and number on card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Merchant ID and card number
merchant | string General Merchant ID |
cardnumber | string Number on card |
Card validation details
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "cardnumber": 9276001234567890,
- "merchant": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}
{- "isValid": false
}
Sets a passcode for the given Merchant Card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Card number and new passcode
merchant | string General Merchant ID |
cardnumber | string Number on card |
passcode | integer Passcode |
Whether the new passcode was saved
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO",
- "cardnumber": 9276001234567890,
- "passcode": 435687
}
{- "result": true
}
Requests to set a new passcode for the given Merchant Card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Card number and current passcode
cardnumber | string Number on card |
passcode | integer Old passcode |
Whether the passcode restore has been started (true
) or not (false
)
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "cardnumber": 9276001234567890,
- "passcode": 435687
}
{- "result": true
}
Checks the passcode for the given Merchant Card.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Information about card
cardnumber | string Number on card |
pin | integer Entered passcode |
Whether the passcode matches (true
) or not (false
)
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "cardnumber": 9276001234567890,
- "pin": 435687
}
{- "result": true
}
Creates multiple Merchant Cards for the given merchant having the given card group.
You can either create one card with customer details, or multiple cards without it.
generalMerchantId required | string General Merchant ID |
loyaltyCardgroupId required | string Loyalty Card Group ID |
Number of cards and customer details
cards_amount | integer [ 1 .. 1000 ] Number of cards to create |
customer | object (LoyaltyMerchantcardsDTOCustomer) LoyaltyMerchantcardsDTOCustomer |
Loyalty Merchant Cards
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "cards_amount": 1,
- "customer": {
- "title": "Herr",
- "forename": "Max",
- "surname": "Mustermann",
- "address": {
- "street": "Musterstr.",
- "street_number": "1a",
- "postal_code": "09999",
- "city": "Musterstadt"
}, - "email": "max@example.com",
- "phone": "0555/5555555-1",
- "mobile": "0155/5555555",
- "fax": "0555/5555555-55",
- "customernumber": "123",
- "note": "Zustimmung erteilt im Mustershop 18.03.2024 15:18",
- "consent_for_communication": "accepted"
}
}
[- {
- "object": "loyalty.merchantcards",
- "id": "MCD_KWESAHFOA0HUZAAPASWQ2T6I4J23HV",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "created_for_merchant": {
- "object": "general.merchants",
- "id": "MRC_RU12NA3BCWT7B4557NOJIKC6S1Z1TO"
}, - "card": {
- "object": "loyalty.cards",
- "id": "CRD_J2KQXWOXLQYJKAEYL55953C3HKKBZ3",
- "cardnumber": "9276001234567890",
- "created": "2024-03-18T15:23:37+01:00"
}, - "cardgroup": {
- "object": "loyalty.cardgroups",
- "id": "CRG_1Z3BZZPM30Y8YK91Z6PHQM7HVQZZHD",
- "display_name": "Kundenkarte",
- "display_name_raw": "Kundenkarte",
- "stock_warn_limit": 0,
}, - "created_for_store": {
- "object": "general.stores",
- "id": "STO_GYVQOSGBBU4W1522FST3K8QDFZZE6T"
}, - "customer": {
- "object": "loyalty.customers",
- "id": "CUS_NJ8L6688IXQJVXUN07W4FT4AV4TZSG",
- "contact": null,
- "created": "2024-03-18T15:23:37+01:00",
- "consent_for_communication": "accepted"
}, - "customer_assignment_date": "2024-03-18T15:23:37+01:00",
- "is_base_card": true,
- "points": 0,
- "cash_balance": 0,
- "bonus_balance": 0,
- "balance": 0,
- "last_usage": null,
- "last_charge": null,
- "stock_status": "stored",
- "lock_status": "unlocked",
- "passcode": 1,
- "expiry_date": null
}
]
Returns a receipt about the card balance. Returns also some more card details in additional fields.
loyaltyMerchantCardId required | string Loyalty Merchant Card ID |
Card number and terminal ID
cardnumber | string Number on card |
terminal_id | string Terminal ID |
Balance receipt and some card details
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "cardnumber": "9276004524764102",
- "terminal_id": 0
}
{- "cardnumber": "9276004524764102",
- "valid": true,
- "balance": 500,
- "cash_balance": 500,
- "bonus_balance": 0,
- "zvt_cardgroup": "00",
- "points": 0,
- "new_passcode": false,
- "receipt_header": [
- {
- "type": "space"
}
], - "receipt": [
- {
- "type": "separator",
- "value": {
- "caption": "Kundenkarte"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Terminal-ID:",
- "value": "VT005264",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Karte:",
- "value": "9276004524764102",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "05.06.2024 12:06:32",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Guthaben:",
- "value": "5,00 €",
- "decoration": [
- "important"
]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Punkte:",
- "value": "0 Punkte",
- "decoration": [
- "important"
]
}
}
], - "amount_split_enabled": true,
- "limit_allowed": false,
- "limit_str": " ",
- "limit": 0
}
Returns the Prepaid Item with the given product ID and amount that is configured for this contract.
prepaidContractId required | string Default: "me" Prepaid contract id |
Product ID and amount
amount | integer (MoneyAmount) Amount in smallest currency unit (e. g. Euro Cent) |
product_id | string ^[0-9]{1,13}$ Product ID of the cash register (ECR); can be padded with leading zeros |
Prepaid item, or result false
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "amount": 1500,
- "product_id": "0000000123456789"
}
{- "item": {
- "object": "prepaid.items",
- "id": "PIT_SVS01GOYPHP17FAI09C9OKXWUOUEQR",
- "description": "Mustermarke Geschenkkarte 15 EUR",
- "retail_price": 1500,
- "currency": "EUR"
}, - "productId": "0000000123456789"
}
Manages the available e-goods products, either PIN printing or POS activation (POSA). Examples for such products are phone charge, or vouchers for an online shop.
Returns the Prepaid Items matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Prepaid Items
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 267,
- "data": [
- {
- "object": "prepaid.items",
- "id": "PIT_T4ENPVUS43H5GT8HH7L7VJ6LRUAJIT",
- "itemgroup": {
- "object": "prepaid.itemgroups",
- "id": "PIG_3RPRX7TBRPA8CNQP14NAAU3Z5ZR2U4",
- "description": "Mustergutschein",
- "logo": null,
- "enabled": true
}, - "retail_price": 2500,
- "description": "Mustergutschein 25 EUR",
- "displaytext": "25,00 EUR",
- "vtc_config": [
- "3451234567890"
], - "taxable": false,
- "type": "POSA",
- "enabled": true
}
]
}
Returns the specified Prepaid Item.
prepaidItemId required | string Prepaid Item ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Prepaid Item
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "prepaid.items",
- "id": "PIT_T4ENPVUS43H5GT8HH7L7VJ6LRUAJIT",
- "itemgroup": {
- "object": "prepaid.itemgroups",
- "id": "PIG_3RPRX7TBRPA8CNQP14NAAU3Z5ZR2U4",
- "description": "Mustergutschein",
- "logo": null,
- "enabled": true
}, - "retail_price": 2500,
- "description": "Mustergutschein 25 EUR",
- "displaytext": "25,00 EUR",
- "vtc_config": [
- "3451234567890"
], - "taxable": false,
- "type": "POSA",
- "enabled": true
}
Returns the Prepaid Reports matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Prepaid Reports
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 135,
- "data": [
- {
- "object": "prepaid.reports",
- "id": "PRE_N9INA5MD8P7EX7KGW7EIA9VSV8GP94",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_1GUZD3W43JKAH8X4F9EMBR6GWP0T3I"
}, - "store": {
- "object": "general.stores",
- "id": "STO_OUMRB9KB523H1JHBEK8JDL119AT4IS"
}, - "device": {
- "object": "smart.devices",
- "id": "SDV_1EW8KVKXX68X90XKAXA9FXGZK63O9N"
}, - "amount": 1500,
- "vtc_tid": "12346578",
- "receipt": [
- {
- "type": "textline",
- "value": {
- "decoration": [ ],
- "text": "Zeitraum"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "von:",
- "value": "09.02.2024 22:53"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "bis:",
- "value": "11.02.2024 23:37"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "Produkt",
- "value": "Anzahl"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "Musteraufladung 15 EUR",
- "value": "1"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "decoration": [
- "important"
], - "name": "Gesamt:",
- "value": "15,00 EUR"
}
}
], - "receipt_header": [
- {
- "type": "separator",
- "value": {
- "caption": "eGoods"
}
}, - {
- "type": "textline",
- "value": {
- "text": "",
- "decoration": [ ]
}
}
], - "report_from": "2024-02-09T22:53:11+01:00",
- "report_to": "2024-02-11T23:37:32+01:00",
- "created": "2024-02-11T23:37:32+01:00"
}
]
}
Generates and returns a new Prepaid Report.
Reporting details
merchant required | string General Merchant ID |
store required | string General Store ID |
smart_device required | string Smart Device ID |
vtc_tid required | integer Terminal ID for VTC Virtual Terminal Client (received during onboarding) |
report_from | string Report start date (ISO-8601 formatted date and time, incl. timezone) |
report_to | string Report end date (ISO-8601 formatted date and time, incl. timezone) |
Newly generated Prepaid Report
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant": "MRC_1GUZD3W43JKAH8X4F9EMBR6GWP0T3I",
- "store": "STO_OUMRB9KB523H1JHBEK8JDL119AT4IS",
- "smart_device": "SDV_1EW8KVKXX68X90XKAXA9FXGZK63O9N",
- "vtc_id": "12346578",
- "report_from": "2024-01-01T00:00:00",
- "report_to": "2024-02-01T:00:00"
}
{- "object": "prepaid.reports",
- "id": "PRE_N9INA5MD8P7EX7KGW7EIA9VSV8GP94",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_1GUZD3W43JKAH8X4F9EMBR6GWP0T3I",
- "parent": null
}, - "store": {
- "object": "general.stores",
- "id": "STO_OUMRB9KB523H1JHBEK8JDL119AT4IS"
}, - "device": {
- "object": "smart.devices",
- "id": "SDV_1EW8KVKXX68X90XKAXA9FXGZK63O9N"
}, - "amount": 1500,
- "vtc_tid": "12346578",
- "receipt": [
- {
- "type": "textline",
- "value": {
- "decoration": [ ],
- "text": "Zeitraum"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "von:",
- "value": "09.02.2024 22:53"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "bis:",
- "value": "11.02.2024 23:37"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "Produkt",
- "value": "Anzahl"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "Musteraufladung 15 EUR",
- "value": "1"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "decoration": [
- "important"
], - "name": "Gesamt:",
- "value": "15,00 EUR"
}
}
], - "receipt_header": [
- {
- "type": "separator",
- "value": {
- "caption": "eGoods"
}
}, - {
- "type": "textline",
- "value": {
- "text": "",
- "decoration": [ ]
}
}
], - "report_from": "2024-02-09T22:53:11+01:00",
- "report_to": "2024-02-11T23:37:32+01:00",
- "created": "2024-02-11T23:37:32+01:00"
}
Returns the specified Prepaid Report.
prepaidReportsId required | object (ProductInstanceUID) Prepaid Reports ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Prepaid Report
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "prepaid.reports",
- "id": "PRE_N9INA5MD8P7EX7KGW7EIA9VSV8GP94",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_1GUZD3W43JKAH8X4F9EMBR6GWP0T3I",
- "parent": null
}, - "store": {
- "object": "general.stores",
- "id": "STO_OUMRB9KB523H1JHBEK8JDL119AT4IS"
}, - "device": {
- "object": "smart.devices",
- "id": "SDV_1EW8KVKXX68X90XKAXA9FXGZK63O9N"
}, - "amount": 1500,
- "vtc_tid": "12346578",
- "receipt": [
- {
- "type": "textline",
- "value": {
- "decoration": [ ],
- "text": "Zeitraum"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "von:",
- "value": "09.02.2024 22:53"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "bis:",
- "value": "11.02.2024 23:37"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "Produkt",
- "value": "Anzahl"
}
}, - {
- "type": "name-value",
- "value": {
- "decoration": [ ],
- "name": "Musteraufladung 15 EUR",
- "value": "1"
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "decoration": [
- "important"
], - "name": "Gesamt:",
- "value": "15,00 EUR"
}
}
], - "receipt_header": [
- {
- "type": "separator",
- "value": {
- "caption": "eGoods"
}
}, - {
- "type": "textline",
- "value": {
- "text": "",
- "decoration": [ ]
}
}
], - "report_from": "2024-02-09T22:53:11+01:00",
- "report_to": "2024-02-11T23:37:32+01:00",
- "created": "2024-02-11T23:37:32+01:00"
}
Returns the Prepaid Sales matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Prepaid Sales
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 12345678,
- "data": [
- {
- "object": "prepaid.sales",
- "id": "PSL_BI7GB94UL1YVE9POJ9TZW6F1AETHOV",
- "stock": {
- "object": "prepaid.stocks",
- "id": "PST_D8Q7CW25XHD67HJ27CETYZ9LV45M8X"
}, - "item": {
- "object": "prepaid.items",
- "id": "PIT_4URW4AX6168KHOTNSUSCGCAF9YH2JW",
- "description": "Musterprodukt 10 EUR",
- "logo": null,
- "type": "PP",
- "taxable": false
}, - "itemgroup": {
- "object": "prepaid.itemgroups",
- "id": "PIG_JL2JK5C4XY8HJOKNFWD0PF984FYSP4",
- "description": "Mustermarke",
}, - "smart_device": {
- "object": "smart.devices",
- "id": "SDV_2G4FBYKBRDAV7RMW1DHIMN05TFJ3MH",
- "description": "Musterkiosk 87654321 23456789 IPP480",
- "vendor_uid": "12345ct7654321"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_AN87IB9PIQNTTUD2S6XA1JF1MJM1CJ"
}, - "contract": {
- "object": "prepaid.contracts",
- "id": "PCO_PVMNSXYQ2F2DUKJ18NZD5K797GTQTO"
}, - "store": {
- "object": "general.stores",
- "id": "STO_4NDQLYSMV6Q9W872Q9FRB8OQL3NH14",
- "name": "Musterstore",
- "name_raw": "Musterstore"
}, - "demo": false,
- "description": "Mustermarke 10 EUR",
- "amount": 1000,
- "currency": "EUR",
- "code": "5501234567890",
- "serial": "500087654321",
- "provider_delivery_number": "123456789012345678",
- "status": "delivered",
- "type": "sale_item",
- "receipt_header": [
- {
- "type": "separator",
- "value": {
- "caption": "Prepaid"
}
}, - {
- "type": "textline",
- "value": {
- "text": "",
- "decoration": [ ]
}
}
], - "receipt_customer": [
- {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "11.08.2019 09:49",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "TAN:",
- "value": "123456789012345678",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Mustermarke",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Betrag:",
- "value": "10,00 EUR",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Seriennummer:",
- "value": "500087654321",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Gueltig bis:",
- "value": "01.08.2023",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*****",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Ihr Auflade-Code lautet:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "5501 2345 6789 0",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*****",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Guthaben aufladen:",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*555* PIN # und dann Anruftaste",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "oder",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Waehlen Sie 555 oder 55# (gratis) und",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "folgen Sie den Anweisungen.",
- "decoration": [ ]
}
}
], - "receipt_zvt": [
- "Datum: 11.08.2019 09:49",
- "TAN: 123456789012345678",
- "",
- "Lycamobile",
- "Betrag: 10,00 EUR",
- "",
- "Seriennummer: 500087654321",
- "Gueltig bis: 01.08.2023",
- "",
- "*****",
- "",
- "Ihr Auflade-Code lautet:",
- "5501 2345 6789 0",
- "",
- "*****",
- "",
- "Guthaben aufladen:",
- " ",
- "*555* PIN # und dann Anruftaste",
- "oder",
- "Waehlen Sie 555 oder 55# (gratis) und",
- "folgen Sie den Anweisungen."
], - "created": "2019-08-11T09:49:18+02:00",
- "expire_date": "2023-08-01T00:00:00+02:00",
- "vtc_tid": "23456789",
- "vtc_id": "4012345678901"
}
]
}
Creates a new Prepaid Sale from the given data.
Sale details
item | string Prepaid Sales Transaction ID |
Newly created Prepaid Sale
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "item": "12345678"
}
{- "object": "prepaid.sales",
- "id": "PSL_BI7GB94UL1YVE9POJ9TZW6F1AETHOV",
- "stock": {
- "object": "prepaid.stocks",
- "id": "PST_D8Q7CW25XHD67HJ27CETYZ9LV45M8X"
}, - "item": {
- "object": "prepaid.items",
- "id": "PIT_4URW4AX6168KHOTNSUSCGCAF9YH2JW",
- "description": "Musterprodukt 10 EUR",
- "logo": null,
- "type": "PP",
- "taxable": false
}, - "itemgroup": {
- "object": "prepaid.itemgroups",
- "id": "PIG_JL2JK5C4XY8HJOKNFWD0PF984FYSP4",
- "description": "Mustermarke",
}, - "smart_device": {
- "object": "smart.devices",
- "id": "SDV_2G4FBYKBRDAV7RMW1DHIMN05TFJ3MH",
- "description": "Musterkiosk 87654321 23456789 IPP480",
- "vendor_uid": "12345ct7654321"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_AN87IB9PIQNTTUD2S6XA1JF1MJM1CJ"
}, - "contract": {
- "object": "prepaid.contracts",
- "id": "PCO_PVMNSXYQ2F2DUKJ18NZD5K797GTQTO"
}, - "store": {
- "object": "general.stores",
- "id": "STO_4NDQLYSMV6Q9W872Q9FRB8OQL3NH14",
- "name": "Musterstore",
- "name_raw": "Musterstore"
}, - "demo": false,
- "description": "Mustermarke 10 EUR",
- "amount": 1000,
- "currency": "EUR",
- "code": "5501234567890",
- "serial": "500087654321",
- "provider_delivery_number": "123456789012345678",
- "status": "delivered",
- "type": "sale_item",
- "receipt_header": [
- {
- "type": "separator",
- "value": {
- "caption": "Prepaid"
}
}, - {
- "type": "textline",
- "value": {
- "text": "",
- "decoration": [ ]
}
}
], - "receipt_customer": [
- {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "11.08.2019 09:49",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "TAN:",
- "value": "123456789012345678",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Mustermarke",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Betrag:",
- "value": "10,00 EUR",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Seriennummer:",
- "value": "500087654321",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Gueltig bis:",
- "value": "01.08.2023",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*****",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Ihr Auflade-Code lautet:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "5501 2345 6789 0",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*****",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Guthaben aufladen:",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*555* PIN # und dann Anruftaste",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "oder",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Waehlen Sie 555 oder 55# (gratis) und",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "folgen Sie den Anweisungen.",
- "decoration": [ ]
}
}
], - "receipt_zvt": [
- "Datum: 11.08.2019 09:49",
- "TAN: 123456789012345678",
- "",
- "Lycamobile",
- "Betrag: 10,00 EUR",
- "",
- "Seriennummer: 500087654321",
- "Gueltig bis: 01.08.2023",
- "",
- "*****",
- "",
- "Ihr Auflade-Code lautet:",
- "5501 2345 6789 0",
- "",
- "*****",
- "",
- "Guthaben aufladen:",
- " ",
- "*555* PIN # und dann Anruftaste",
- "oder",
- "Waehlen Sie 555 oder 55# (gratis) und",
- "folgen Sie den Anweisungen."
], - "created": "2019-08-11T09:49:18+02:00",
- "expire_date": "2023-08-01T00:00:00+02:00",
- "vtc_tid": "23456789",
- "vtc_id": "4012345678901"
}
Returns the specified Prepaid Sale.
prepaidSaleId required | string <id> (ObjectId) Example: OBJ_MNTPQ9IFD3V482Y6VMHJXERBYS4J1G Prepaid Sale ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Prepaid Sale
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "prepaid.sales",
- "id": "PSL_BI7GB94UL1YVE9POJ9TZW6F1AETHOV",
- "stock": {
- "object": "prepaid.stocks",
- "id": "PST_D8Q7CW25XHD67HJ27CETYZ9LV45M8X"
}, - "item": {
- "object": "prepaid.items",
- "id": "PIT_4URW4AX6168KHOTNSUSCGCAF9YH2JW",
- "description": "Musterprodukt 10 EUR",
- "logo": null,
- "type": "PP",
- "taxable": false
}, - "itemgroup": {
- "object": "prepaid.itemgroups",
- "id": "PIG_JL2JK5C4XY8HJOKNFWD0PF984FYSP4",
- "description": "Mustermarke",
}, - "smart_device": {
- "object": "smart.devices",
- "id": "SDV_2G4FBYKBRDAV7RMW1DHIMN05TFJ3MH",
- "description": "Musterkiosk 87654321 23456789 IPP480",
- "vendor_uid": "12345ct7654321"
}, - "merchant": {
- "object": "general.merchants",
- "id": "MRC_AN87IB9PIQNTTUD2S6XA1JF1MJM1CJ"
}, - "contract": {
- "object": "prepaid.contracts",
- "id": "PCO_PVMNSXYQ2F2DUKJ18NZD5K797GTQTO"
}, - "store": {
- "object": "general.stores",
- "id": "STO_4NDQLYSMV6Q9W872Q9FRB8OQL3NH14",
- "name": "Musterstore",
- "name_raw": "Musterstore"
}, - "demo": false,
- "description": "Mustermarke 10 EUR",
- "amount": 1000,
- "currency": "EUR",
- "code": "5501234567890",
- "serial": "500087654321",
- "provider_delivery_number": "123456789012345678",
- "status": "delivered",
- "type": "sale_item",
- "receipt_header": [
- {
- "type": "separator",
- "value": {
- "caption": "Prepaid"
}
}, - {
- "type": "textline",
- "value": {
- "text": "",
- "decoration": [ ]
}
}
], - "receipt_customer": [
- {
- "type": "name-value",
- "value": {
- "name": "Datum:",
- "value": "11.08.2019 09:49",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "TAN:",
- "value": "123456789012345678",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Mustermarke",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Betrag:",
- "value": "10,00 EUR",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "name-value",
- "value": {
- "name": "Seriennummer:",
- "value": "500087654321",
- "decoration": [ ]
}
}, - {
- "type": "name-value",
- "value": {
- "name": "Gueltig bis:",
- "value": "01.08.2023",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*****",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Ihr Auflade-Code lautet:",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "5501 2345 6789 0",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*****",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "Guthaben aufladen:",
- "decoration": [ ]
}
}, - {
- "type": "space"
}, - {
- "type": "textline",
- "value": {
- "text": "*555* PIN # und dann Anruftaste",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "oder",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "Waehlen Sie 555 oder 55# (gratis) und",
- "decoration": [ ]
}
}, - {
- "type": "textline",
- "value": {
- "text": "folgen Sie den Anweisungen.",
- "decoration": [ ]
}
}
], - "receipt_zvt": [
- "Datum: 11.08.2019 09:49",
- "TAN: 123456789012345678",
- "",
- "Lycamobile",
- "Betrag: 10,00 EUR",
- "",
- "Seriennummer: 500087654321",
- "Gueltig bis: 01.08.2023",
- "",
- "*****",
- "",
- "Ihr Auflade-Code lautet:",
- "5501 2345 6789 0",
- "",
- "*****",
- "",
- "Guthaben aufladen:",
- " ",
- "*555* PIN # und dann Anruftaste",
- "oder",
- "Waehlen Sie 555 oder 55# (gratis) und",
- "folgen Sie den Anweisungen."
], - "created": "2019-08-11T09:49:18+02:00",
- "expire_date": "2023-08-01T00:00:00+02:00",
- "vtc_tid": "23456789",
- "vtc_id": "4012345678901"
}
Confirms and executes the specified Prepaid Sale.
prepaidSaleId required | string <id> (ObjectId) Example: OBJ_MNTPQ9IFD3V482Y6VMHJXERBYS4J1G Prepaid Sale ID |
Updated Prepaid Sale
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "module.type",
- "id": "OBJ_MNTPQ9IFD3V482Y6VMHJXERBYS4J1G",
- "created": "2020-09-04T18:09:51+02:00",
- "status": "string",
- "type": "string",
- "stock": {
- "object": "string",
- "id": "string"
}, - "item": {
- "object": "string",
- "id": "string",
- "description": "string",
- "logo": "string",
- "type": "string"
}, - "itemgroup": {
- "object": "prepaid.itemgroups",
- "id": "PIG_A1YR86XYVHO5N7B2VQ1X9T4G1UISR1",
- "description": "Mustermarke",
- "logo": "string",
- "enabled": true
}, - "smart_device": {
- "object": "string",
- "id": "string",
- "description": "string",
- "vendor_uid": "string"
}, - "merchant": {
- "object": "string",
- "id": "string"
}, - "store": {
- "object": "string",
- "id": "string",
- "name": "string"
}, - "contract": {
- "object": "string",
- "id": "string"
}, - "demo": true,
- "description": "string",
- "amount": 1995,
- "currency": "EUR",
- "commission": 0,
- "commission_currency": "string",
- "code": "string",
- "serial": "string",
- "cardnumber": "string",
- "expire_date": "string",
- "provider_delivery_number": "string",
- "receipt_header": "string",
- "receipt_customer": "string",
- "receipt_zvt": "string",
- "receipt_dealer": "string",
- "vtc_tid": "string",
- "vtc_id": "string",
- "password": "string"
}
A Smart Device is a device like a POS payment terminal, or an electronic cash register (ECR). You can interconnect such devices with each other (s. Smart Routings), with our systems acting as intermediaries. Every Smart Device belongs to a store (s. General Stores). There are also virtual devices for specific tasks.
Returns the Smart Devices matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Smart Devices
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 8734,
- "data": [
- {
- "object": "smart.devices",
- "id": "SDV_F7T8R23B2P7RVAR5WQWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K"
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Store name",
- "name_raw": "Raw store name"
}, - "vendor": "apidevices",
- "vendor_uid": "/uuid/xxxxxxxxxxxx",
- "type": "cashier",
- "description": "Kasse Store XYZ",
- "user_pin": "XXXXXXXX",
- "products": {
- "smart": {
- "enabled": true
}
}, - "status": "active",
- "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "routing": {
- "object": "smart.routings",
- "id": "SRT_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH"
}, - "refresh": 0,
- "connection_type": null,
- "online": false
}, - {
- "object": "smart.devices",
- "id": "SDV_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K"
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Shop name",
- "name_raw": "Raw shop name"
}, - "vendor": "shopware",
- "vendor_uid": "/uuid/xxxxxxxxxxxx",
- "type": "cashier",
- "description": "Shopware Shop",
- "device": {
- "object": "general.devices",
- "id": "DEV_23TBQAPB6DC0X7YKD3CRMT6HH0DPFP",
- "serial_number": "VTXXXXXXXXXXXXX",
- "tid": "VTXXXXXX"
}, - "user_pin": "XXXXXXXX",
- "products": {
- "loyalty": {
- "enabled": true
}
}, - "status": "active",
- "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "refresh": 0,
- "connection_type": null,
- "online": false
}
]
}
Creates a new Smart Device from the given data.
Smart Device details
merchant | string Merchant |
store | string Store |
device | string Device |
contract | string Contract |
vendor | string Vendor, examples:
|
vendor_uid | string Vendor uid |
type | string Type:
|
description | string Device description |
tid | string TID |
products | object (SmartDevicesProducts) SmartDevicesProducts |
terminal_type | string Terminal type |
base_version | string Base version |
status | string (DeviceStatus) Enum: "active" "inactive" "deleted" "replaced" Status for the device |
Newly created Smart Device
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant_id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "store": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "vendor": "apidevices",
- "vendor_uid": "/uuid/xxxxxxxxxxxx",
- "type": "cashier"
}
{- "object": "smart.devices",
- "id": "SDV_F7T8R23B2P7RVAR5WQWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K"
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Shop name",
- "name_raw": "Raw shop name"
}, - "vendor": "apidevices",
- "vendor_uid": "/uuid/xxxxxxxxxxxx",
- "type": "cashier",
- "description": null,
- "status": "active",
- "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "refresh": 0,
- "connection_type": null
}
Returns the specified Smart Device.
smartDeviceId required | string Smart device id |
expand | string Example: expand=true Expand fields (all or a specific one) |
Smart Device
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.devices",
- "id": "SDV_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K"
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Shop name",
- "name_raw": "Raw shop name"
}, - "vendor": "shopware",
- "vendor_uid": "/uuid/xxxxxxxxxxxx",
- "type": "cashier",
- "description": "Shopware Shop",
- "device": {
- "object": "general.devices",
- "id": "DEV_23TBQAPB6DC0X7YKD3CRMT6HH0DPFP",
- "serial_number": "VTXXXXXXXXXXXXX",
- "tid": "VTXXXXXX"
}, - "user_pin": "XXXXXXXX",
- "products": {
- "loyalty": {
- "enabled": true
}
}, - "status": "active",
- "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "refresh": 0,
- "connection_type": null,
- "online": false
}
Updates the specified Smart Device with the given data.
smartDeviceId required | string Smart Device ID |
Smart device properties
merchant | string Merchant |
store | string Store |
device | string Device |
contract | string Contract |
vendor | string Vendor, examples:
|
vendor_uid | string Vendor uid |
type | string Type:
|
description | string Device description |
tid | string TID |
products | object (SmartDevicesProducts) SmartDevicesProducts |
terminal_type | string Terminal type |
base_version | string Base version |
status | string (DeviceStatus) Enum: "active" "inactive" "deleted" "replaced" Status for the device |
Updated smart device
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "products": {
- "loyalty": {
- "enabled": true
}
}
}
{- "object": "smart.devices",
- "id": "SDV_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K"
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Shop name",
- "name_raw": "Raw shop name"
}, - "vendor": "apidevices",
- "vendor_uid": "/uuid/xxxxxxxxxxxx",
- "type": "cashier",
- "description": "Kasse Store XYZ",
- "products": {
- "loyalty": {
- "enabled": true
}
}, - "status": "active",
- "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "refresh": 0,
- "connection_type": null
}
Returns the specified Smart Device if it is assigned to a routing.
smartDeviceId required | string Smart Device ID |
type required | string Smart Device type:
|
Smart Device
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.devices",
- "id": "SDV_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K"
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Shop name",
- "name_raw": "Raw shop name"
}, - "vendor": "ingenico",
- "vendor_uid": "/serial/xxxxxxxxxxxx",
- "type": "zvt",
- "description": "Terminal Filiale XY",
- "device": {
- "object": "general.devices",
- "id": "DEV_23TBQAPB6DC0X7YKD3CRMT6HH0DPFP",
- "serial_number": "VTXXXXXXXXXXXXX",
- "tid": "VTXXXXXX"
}, - "user_pin": "XXXXXXXX",
- "products": {
- "loyalty": {
- "enabled": true
}
}, - "status": "active",
- "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "routing": {
- "object": "smart.routings",
- "id": "SRT_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH"
}, - "refresh": 0,
- "connection_type": null,
- "online": false
}
Sets the PIN that needs to be passed to authenticate the Smart Device.
smartDeviceId required | string Smart Device ID |
user_pin | string PIN / user code from authentication response |
current smart device object
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "user_pin": "6vfgr9qz"
}
{- "object": "smart.devices",
- "id": "SDV_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K"
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Shop name",
- "name_raw": "Raw shop name"
}, - "vendor": "ingenico",
- "vendor_uid": "/serial/xxxxxxxxxxxx",
- "type": "zvt",
- "description": "Terminal Filiale XY",
- "device": {
- "object": "general.devices",
- "id": "DEV_23TBQAPB6DC0X7YKD3CRMT6HH0DPFP",
- "serial_number": "VTXXXXXXXXXXXXX",
- "tid": "VTXXXXXX"
}, - "user_pin": "XXXXXXXX",
- "products": {
- "loyalty": {
- "enabled": true
}
}, - "status": "active",
- "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "refresh": 0,
- "connection_type": null
}
Sets the device PIN at merchant, store or device level. The device PIN must be passed to authenticate the Smart Device.
smartDeviceId required | string Smart Device ID, or any other value when the PIN is set at store or merchant level |
store_id | string Nullable General Stores ID |
merchant_id required | string General Merchants ID |
pin required | string The pin to store |
Whether it was set (true
) or not
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant_id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "store_id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "pin": "zoj8AosJgfgLi1o7BD1M74cWhkn8K5"
}
{- "result": true
}
Returns the device PIN settings. This is not the actual PIN, but whether it must be passed on merchant, store or device level.
smartDeviceId required | string Smart Device ID |
PIN settings
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "merchant": {
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "auth_password_set": false
}, - "store": {
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "auth_password_set": false
}, - "smart_device": {
- "id": "SDV_F7T8R23B2P7RVAR5WQWVNP689Z9QTH",
- "auth_password_set": true
}
}
Returns the Secubase config of the Smart Device.
smartDeviceId required | string Smart Device ID |
Smart Device properties
secubase_version | string Secubase version of the Ingenico terminal (C part) |
secudroid_version | string Version of the Android app (Java part) |
base_version | string Lua base app version |
terminal_type | string Terminal model |
terminal_id | string Terminal ID |
smart_device | object (SmartDevicesProductModel) Default: {} Smart Device |
Smart Device Secubase configuration
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "base_version": "0.2.5",
- "secubase_version": "3.0.1-pre.2",
- "terminal_type": "MOVE5000",
- "terminal_id": "75352828"
}
{- "apps": [
- {
- "app_id": "APP_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "app_name": "Loyalty",
- "version": "0.2.1",
- "etag": "fsgkpduw9nw9siusowesfi30eamo70jr",
- "prio": 10
}
]
}
A routing defines a connection between two Smart ZVT eligible devices (s. Smart Devices). For instance you can flexibly connect electronic cash registers (ECR) with POS payment terminals. Our server can use the same link to trigger ZVT functions for a different purpose, for instance to integrate e-commerce with your point of sale (POS), which is commonly known as cross-channel, omni-channel, or multi-channel.
Returns the Smart Routings matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Smart Routings
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 148,
- "data": [
- {
- "object": "smart.routings",
- "id": "SRT_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_FMP885SKMIQ6LTZ014C9GA7NKQIP2K",
- "parent": null
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Store im Mustercenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "description": "Kasse 3",
- "assign": [
- {
- "object": "smart.devices",
- "id": "SDV_F7T8R23B2P7RVAR5WQWVNP689Z9QTH",
- "type": "cashier",
- "description": "Kasse 3 Store XYZ"
}, - {
- "object": "smart.devices",
- "id": "SDV_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "type": "zvt",
- "description": "Terminal 3 Store XYZ"
}
]
}, - {
- "object": "smart.routings",
- "id": "SRT_X4NLU2C45H1QLN0RS64HP31SWY9JXM",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_2YNYUX0MKT9DM1RWE1AB8O9DHAPRPN",
- "parent": null
}, - "store": {
- "object": "general.stores",
- "id": "STO_WKVL5NJ8XY17E6QUFTPZCL8AVR2P9J",
- "name": "Store im Mustercenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "description": "Kasse 5",
- "assign": [
- {
- "object": "smart.devices",
- "id": "SDV_7TNBKNVATSMNV4WY9Q2SM2H6OYR5NJ",
- "type": "cashier",
- "description": "Kasse 5 Store XYZ"
}, - {
- "object": "smart.devices",
- "id": "SDV_IXY12KTT0ZUHWFHAAQP43LDWM550N0",
- "type": "zvt",
- "description": "Terminal 5 Store XYZ"
}
]
}
]
}
Creates a new Smart Routing from the given data.
Smart Routing details
store | string General Store ID |
description | string Route description |
Newly created Smart Routing
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "store": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "description": "Kasse 3"
}
{- "object": "smart.routings",
- "id": "SRT_8ISKYZGZ9BXUMZ3LF4VIA4ZAA26NIO",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_XTWA9BI8TJU5JUOAOSZAL7WG0L9A7B",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_DJ71CC369Z10T15WAQ5NJG9OONOK0M",
- "type": 16
}
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Store im Mustercenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "description": "Kasse 3"
}
Returns the specified Smart Routing.
smartRoutingId required | string Smart Routing ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Smart Routing
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.routings",
- "id": "SRT_8ISKYZGZ9BXUMZ3LF4VIA4ZAA26NIO",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_XTWA9BI8TJU5JUOAOSZAL7WG0L9A7B",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_DJ71CC369Z10T15WAQ5NJG9OONOK0M",
- "type": 16
}
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Store im Mustercenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "description": "Kasse 3"
}
Updates the specified Smart Routing with the given data.
smartRoutingId required | string Smart Routing ID |
Smart Routing details
store | string General Store ID |
description | string Route description |
Updated Smart Routing
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "store": "STO_HLNVCU8510FYS1TLUBETKMER3ITZ5C",
- "description": "Kasse 7"
}
{- "object": "smart.routings",
- "id": "SRT_8ISKYZGZ9BXUMZ3LF4VIA4ZAA26NIO",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_XTWA9BI8TJU5JUOAOSZAL7WG0L9A7B",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_DJ71CC369Z10T15WAQ5NJG9OONOK0M",
- "type": 16
}
}, - "store": {
- "object": "general.stores",
- "id": "STO_HLNVCU8510FYS1TLUBETKMER3ITZ5C",
- "name": "Store im Mustercenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-16T10:00:00+01:00",
- "description": "Kasse 7"
}
Deletes the specified Smart Routing.
smartRoutingId required | string Smart Routing ID |
Deleted Smart Routing
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.routings",
- "id": "SRT_8ISKYZGZ9BXUMZ3LF4VIA4ZAA26NIO",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_XTWA9BI8TJU5JUOAOSZAL7WG0L9A7B",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_DJ71CC369Z10T15WAQ5NJG9OONOK0M",
- "type": 16
}
}, - "store": {
- "object": "general.stores",
- "id": "STO_HLNVCU8510FYS1TLUBETKMER3ITZ5C",
- "name": "Store im Alten Beispielcenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-16T10:00:00+01:00",
- "description": "Kasse 7"
}
Assigns the specified Smart Device to the specified Smart Routing.
smartRoutingId required | string Smart Routing ID |
smartDeviceId required | string Smart Device ID |
Updated Smart Routing
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.routings",
- "id": "SRT_8ISKYZGZ9BXUMZ3LF4VIA4ZAA26NIO",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_XTWA9BI8TJU5JUOAOSZAL7WG0L9A7B",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_DJ71CC369Z10T15WAQ5NJG9OONOK0M",
- "type": 16
}
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Store im Mustercenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "description": "Kasse 3",
- "assign": [
- {
- "object": "smart.devices",
- "id": "SDV_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH",
- "type": "cashier",
- "description": "Kasse Store XYZ"
}
]
}
Unassigns the specified Smart Device from the specified Smart Routing.
smartRoutingId required | string Smart Routing ID |
smartDeviceId required | string Smart Device ID |
Updated Smart Routing
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "smart.routings",
- "id": "SRT_8ISKYZGZ9BXUMZ3LF4VIA4ZAA26NIO",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_XTWA9BI8TJU5JUOAOSZAL7WG0L9A7B",
- "parent": {
- "object": "general.merchants",
- "id": "MRC_DJ71CC369Z10T15WAQ5NJG9OONOK0M",
- "type": 16
}
}, - "store": {
- "object": "general.stores",
- "id": "STO_YPPAYAHBK0I9SYDWEHBFQEESTOVBP5",
- "name": "Store im Mustercenter"
}, - "created": "2024-03-15T10:00:00+01:00",
- "updated": "2024-03-15T10:00:00+01:00",
- "description": "Kasse 3"
}
Creates a new Docuemt Upload from the given data.
multipart | string |
Input data format
file | string <binary> |
Document uploaded
Response related to the error
Production environment
Testing environment
Staging environment
{- "file": "/path/to/file.txt"
}
{- "object": "module.type",
- "id": "OBJ_MNTPQ9IFD3V482Y6VMHJXERBYS4J1G",
- "created": "2020-09-04T18:09:51+02:00",
- "type": "text/plain",
- "name": "hello.txt",
- "size": 13
}
Creates a new Document Upload from the given data.
Content
content | string File content as Base64 encoded string |
Document uploaded
Response related to the error
Production environment
Testing environment
Staging environment
{- "content": "SGVsbG8sIFdvcmxkIQ=="
}
{- "object": "module.type",
- "id": "OBJ_MNTPQ9IFD3V482Y6VMHJXERBYS4J1G",
- "created": "2020-09-04T18:09:51+02:00"
}
Returns the specified Document Upload.
documentUploadsId required | string Example: DUP_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH Document Uploads ID |
Returns the document info
Response related to the error
Production environment
Testing environment
Staging environment
{- "object": "module.type",
- "id": "OBJ_MNTPQ9IFD3V482Y6VMHJXERBYS4J1G",
- "created": "2020-09-04T18:09:51+02:00",
- "type": "text/plain",
- "name": "hello.txt",
- "size": 13,
- "content": "SGVsbG8sIFdvcmxkIQ=="
}
Downloads the contents of the specified Document Upload.
documentUploadsId required | string Example: DUP_D2T3Q24B2P7RVAR5WSWVNP689Z9QTH Document Uploads ID |
Returns the uploaded document
Response related to the error
Production environment
Testing environment
Staging environment
"Hello, World!"
Creates an Ident Request, connected with a particular Payment Transaction for payout.
Creates a new Upload Ident from the given data.
Upload Ident details
merchant_id | string Merchant ID |
payment_id | string Payment ID |
contract_id | string Contract ID |
apikey | string Api Key |
service_issue_id | integer Service issue id |
document_ids | Array of strings List of documents ids |
Newly created Upload Ident
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "contract_id": "GCR_7GDYFMMJ9SK75P2BJRRN6JA8Y0DSOJ",
- "documents": [
- "DUF_8Z092GGNK60KD94JPZFKYDS6C67X4C",
- "DUP_37L1T9B3BYGVTJ759FOKXFFPJY0NVG"
]
}
{- "service_issue_id": 12345678
}
Returns the Ident Requests matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Ident Requests
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 1,
- "data": [
- {
- "object": "services.identrequests",
- "id": "SIR_ANP0CG8Z5FVWE5DNH1ZYIPPLD2G09L",
- "contract": {
- "object": "services.identcontracts",
- "id": "SIC_BK1BC79CRAQ9WA1LC3L0FURU321UUH"
}, - "type": "person",
- "provider": "idnow",
- "status": "requested",
- "demo": true,
- "owner_transaction_id": "tx_1234567890",
- "person": [
- {
- "transaction_id": "12a3b4cd5ef6gh",
- "status": "requested",
- "contact": {
- "salutation": "Herr",
- "forename": "Max",
- "surname": "Mustermann",
- "name": "Max Mustermann",
- "phone": "+4935955755050",
- "dob": "1980-12-31T00:00:00+01:00",
- "birthplace": "Dresden",
- "nationality": "DE",
- "email": "max@example.net",
- "mobile": "+495555555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55 a",
- "city": "Musterstadt",
- "postal_code": "09123",
- "country": "DE"
}
}, - "custom1": "Mein Text Zeile 1",
- "custom2": "Mein Text Zeile 2",
- "custom3": null,
- "custom4": null,
- "custom5": null
}
], - "created": "2017-01-26T12:29:27+00:00"
}
]
}
Creates a new Ident Request from the given data.
Ident Request details
provider | string (IdentProviderValue) Third party Identification provider:
|
type | string (IdentTypeValue) Ident type (mostly |
demo | boolean Demo Flag |
person | Array of objects (IdentrequestPersonDTO) The person which should be identified by third party provider |
owner_transaction_id | string Arbitrary ID to identify identrequest on merchant |
redirect_urls | object (IdentrequestRedirectUrls) Nullable Ident Request redirect URLs |
Newly created Ident Request
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "type": "person",
- "demo": "true",
- "owner_transaction_id": "tx_1234567890",
- "person": [
- {
- "contact": {
- "salutation": "Herr",
- "forename": "Max",
- "surname": "Mustermann",
- "dob": "1980-12-31",
- "birthplace": "Dresden",
- "nationality": "de",
- "email": "max@example.net",
- "phone": "+495555555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55 a",
- "city": "Musterstadt",
- "country": "DE",
- "postal_code": "09123"
}
}, - "custom1": "Mein Text Zeile 1",
- "custom2": "Mein Text Zeile 2",
- "custom3": null,
- "custom4": null,
- "custom5": null
}
]
}
{- "object": "services.identrequests",
- "id": "SIR_ANP0CG8Z5FVWE5DNH1ZYIPPLD2G09L",
- "contract": {
- "object": "services.identcontracts",
- "id": "SIC_BK1BC79CRAQ9WA1LC3L0FURU321UUH"
}, - "type": "person",
- "provider": "idnow",
- "status": "requested",
- "demo": true,
- "owner_transaction_id": "tx_1234567890",
- "person": [
- {
- "transaction_id": "12a3b4cd5ef6gh",
- "status": "requested",
- "contact": {
- "salutation": "Herr",
- "forename": "Max",
- "surname": "Mustermann",
- "name": "Max Mustermann",
- "phone": "+4935955755050",
- "dob": "1980-12-31T00:00:00+01:00",
- "birthplace": "Dresden",
- "nationality": "DE",
- "email": "max@example.net",
- "mobile": "+495555555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55 a",
- "city": "Musterstadt",
- "postal_code": "09123",
- "country": "DE"
}
}, - "custom1": "Mein Text Zeile 1",
- "custom2": "Mein Text Zeile 2",
- "custom3": null,
- "custom4": null,
- "custom5": null
}
], - "created": "2017-01-26T12:29:27+00:00"
}
Returns the specified Ident Request.
identrequestId required | string Ident Request ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Ident Request
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "services.identrequests",
- "id": "SIR_ANP0CG8Z5FVWE5DNH1ZYIPPLD2G09L",
- "contract": {
- "object": "services.identcontracts",
- "id": "SIC_BK1BC79CRAQ9WA1LC3L0FURU321UUH"
}, - "type": "person",
- "provider": "idnow",
- "status": "requested",
- "demo": true,
- "owner_transaction_id": "tx_1234567890",
- "person": [
- {
- "transaction_id": "12a3b4cd5ef6gh",
- "status": "requested",
- "contact": {
- "salutation": "Herr",
- "forename": "Max",
- "surname": "Mustermann",
- "name": "Max Mustermann",
- "phone": "+4935955755050",
- "dob": "1980-12-31T00:00:00+01:00",
- "birthplace": "Dresden",
- "nationality": "DE",
- "email": "max@example.net",
- "mobile": "+495555555555",
- "address": {
- "street": "Musterstr.",
- "street_number": "55 a",
- "city": "Musterstadt",
- "postal_code": "09123",
- "country": "DE"
}
}, - "custom1": "Mein Text Zeile 1",
- "custom2": "Mein Text Zeile 2",
- "custom3": null,
- "custom4": null,
- "custom5": null
}
], - "created": "2017-01-26T12:29:27+00:00"
}
Detailed results for an Ident Request (ID document, stills or videos, corrected spellings, etc.)
Returns the Ident Results matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Ident Results
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 1,
- "data": [
- {
- "object": "services.identresults",
- "id": "SIS_331L21T3A105WIJSNVTAKSDKZHE7IK",
- "request": {
- "object": "services.identrequests",
- "id": "SIR_LP4QR8ALRNR6ARGUIMAQTGXJ8XNEO6",
- "assignment": null
}, - "contract": {
- "object": "services.identcontracts",
- "id": "SIC_ZCO4LY3QTTVHJMBY58ZSDIQE4TBO6Y"
}, - "status": "ok",
- "demo": true,
- "person": [
- {
- "identificationprocess": {
- "status": "ok",
- "identificationtime": "2022-05-30T15:10:11+02:00",
- "transactionnumber": "12abc3456d7e89"
}, - "customdata": null,
- "contactdata": {
- "email": null,
- "mobile": null
}, - "attachments": [
- {
- "type": "jpg",
}, - {
- "type": "pdf",
}, - {
- "type": "jpg2",
}, - {
- "type": "jpg3",
}, - {
- "type": "json",
}
], - "userdata": {
- "forename": {
- "value": "Max"
}, - "surname": {
- "value": "Mustermann"
}, - "address": {
- "street": {
- "value": "Musterstr."
}, - "street_number": {
- "value": "55 a"
}, - "city": {
- "value": "Musterstadt"
}, - "postal_code": {
- "value": "09123"
}, - "country": {
- "value": "DE"
}
}, - "nationality": {
- "value": "DE"
}, - "dob": {
- "value": "1970-01-01"
}, - "birthplace": {
- "value": "Musterstadt"
}
}, - "identificationdocument": {
- "country": {
- "value": "DEU"
}, - "issued_by": {
- "value": "Stadt Musterstadt"
}, - "issued_in_city": {
- "value": null
}, - "type": {
- "value": "1"
}, - "number": {
- "value": "XXXXXXXXX"
}, - "dateissued": {
- "value": "2018-01-02"
}, - "validuntil": {
- "value": "2028-01-02"
}
}
}
], - "created": "2022-05-30T15:01:02+02:00"
}
]
}
Returns the specified Ident Result.
identrequestId required | string Identresult Id |
expand | string Example: expand=true Expand fields (all or a specific one) |
Ident Result
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "services.identresults",
- "id": "SIS_331L21T3A105WIJSNVTAKSDKZHE7IK",
- "request": {
- "object": "services.identrequests",
- "id": "SIR_LP4QR8ALRNR6ARGUIMAQTGXJ8XNEO6",
- "assignment": null
}, - "contract": {
- "object": "services.identcontracts",
- "id": "SIC_ZCO4LY3QTTVHJMBY58ZSDIQE4TBO6Y"
}, - "status": "ok",
- "demo": true,
- "person": [
- {
- "identificationprocess": {
- "status": "ok",
- "identificationtime": "2022-05-30T15:10:11+02:00",
- "transactionnumber": "12abc3456d7e89"
}, - "customdata": null,
- "contactdata": {
- "email": null,
- "mobile": null
}, - "attachments": [
- {
- "type": "jpg",
}, - {
- "type": "pdf",
}, - {
- "type": "jpg2",
}, - {
- "type": "jpg3",
}, - {
- "type": "json",
}
], - "userdata": {
- "forename": {
- "value": "Max"
}, - "surname": {
- "value": "Mustermann"
}, - "address": {
- "street": {
- "value": "Musterstr."
}, - "street_number": {
- "value": "55 a"
}, - "city": {
- "value": "Musterstadt"
}, - "postal_code": {
- "value": "09123"
}, - "country": {
- "value": "DE"
}
}, - "nationality": {
- "value": "DE"
}, - "dob": {
- "value": "1970-01-01"
}, - "birthplace": {
- "value": "Musterstadt"
}
}, - "identificationdocument": {
- "country": {
- "value": "DEU"
}, - "issued_by": {
- "value": "Stadt Musterstadt"
}, - "issued_in_city": {
- "value": null
}, - "type": {
- "value": "1"
}, - "number": {
- "value": "XXXXXXXXX"
}, - "dateissued": {
- "value": "2018-01-02"
}, - "validuntil": {
- "value": "2028-01-02"
}
}
}
], - "created": "2022-05-30T15:01:02+02:00"
}
Returns the Card Processing Transactions matching the given criteria.
count | integer Example: count=20 The maximum number of items to return |
offset | integer Example: offset=0 The position within the whole result set to start returning items (zero-based) |
fields | string Example: fields=prop3,prop1.prop2 List of fields to include in the result, all others will be filtered out. Nested properties can be accessed with this notation: |
q | string Example: q=card.cardnumber:92760044 A query string to restrict the returned items to given conditions. The query string must consist of any combination of single expressions in the form Example: A condition may contain:
You can also use value ranges in the form Example: You can combine expressions logically by Example: |
sort | string Example: sort=contact.surname:asc,contact.companyname:desc String with comma separated pairs of Options for order:
|
aggregate | object (Aggregate) Aggregation summarizes your data. |
meta | any Enum: "true" "only" return field definitions |
validate | any Value: 1 Check syntax of a query string |
scroll_expire | string Example: scroll_expire=1m How long it should keep the “search context” alive? |
scroll_id | string Example: scroll_id=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAD4WYm9laVYtZndUQlNsdDcwakFMNjU1QQ== Identifier of a previous search context. |
preset | string Example: preset=own Query presets |
expand | string Example: expand=true Expand fields (all or a specific one) |
Matching Card Processing Transactions
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "count": 10000,
- "data": [
- {
- "object": "cardprocessing.transactions",
- "id": "PTX_R0AW78IGZB5G6UQNCI9FU15KYDEULB",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5I3SA18OAR9ZTA0V3YQ84WWIGZ658X",
- "type": 46
}, - "store": {
- "object": "general.stores",
- "id": "STO_HUG1REXYTIMQA47PD2BXIV185U25CG"
}, - "store_name": "Mustershop",
- "trans_id": 123456789,
- "tid": "99999999",
- "end_of_day_date": "2021-05-31T00:00:00+02:00",
- "end_of_day_id": "09999999999",
- "amount": 9900,
- "trace": 999,
- "receipt_number": "12345",
- "product": "girocard",
- "ref_report_id": 99999999,
- "ref_report_type": 4,
- "created": "2021-05-30T12:34:56+02:00",
- "updated": "2021-06-01T12:00:00+02:00"
}
]
}
Returns the specified Card Processing Transaction.
cardprocessingTransactionId required | string Card Processing Transaction ID |
expand | string Example: expand=true Expand fields (all or a specific one) |
Card Processing Transaction
Missing or invalid token
Not logged in or no contract
Resource not found or no permission
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
{- "object": "cardprocessing.transactions",
- "id": "PTX_R0AW78IGZB5G6UQNCI9FU15KYDEULB",
- "merchant": {
- "object": "general.merchants",
- "id": "MRC_5I3SA18OAR9ZTA0V3YQ84WWIGZ658X",
- "type": 46
}, - "store": {
- "object": "general.stores",
- "id": "STO_HUG1REXYTIMQA47PD2BXIV185U25CG"
}, - "store_name": "Mustershop",
- "trans_id": 123456789,
- "tid": "99999999",
- "end_of_day_date": "2021-05-31T00:00:00+02:00",
- "end_of_day_id": "09999999999",
- "amount": 9900,
- "trace": 999,
- "receipt_number": "12345",
- "product": "girocard",
- "ref_report_id": 99999999,
- "ref_report_type": 4,
- "created": "2021-05-30T12:34:56+02:00",
- "updated": "2021-06-01T12:00:00+02:00"
}
Returns the available countries.
Available countries
Missing or invalid token
Not logged in or no contract
Validation errors, etc.
Other errors
Production environment
Testing environment
Staging environment
[- {
- "en": "Afghanistan",
- "iso_code": "AF",
- "de": "Afghanistan"
}, - {
- "en": "Albania",
- "iso_code": "AL",
- "de": "Albanien"
}, - {
- "en": "Algeria",
- "iso_code": "DZ",
- "de": "Algerien"
}, - {
- "en": "American Samoa",
- "iso_code": "AS",
- "de": "Amerikanisch-Samoa"
}, - {
- "en": "Andorra",
- "iso_code": "AD",
- "de": "Andorra"
}, - {
- "en": "Angola",
- "iso_code": "AO",
- "de": "Angola"
}, - {
- "en": "Anguilla",
- "iso_code": "AI",
- "de": "Anguilla"
}, - {
- "en": "Antarctica",
- "iso_code": "AQ",
- "de": "Antarktis"
}, - {
- "en": "Antigua and Barbuda",
- "iso_code": "AG",
- "de": "Antigua und Barbuda"
}, - {
- "en": "Argentina",
- "iso_code": "AR",
- "de": "Argentinien"
}, - {
- "en": "Armenia",
- "iso_code": "AM",
- "de": "Armenien"
}, - {
- "en": "Aruba",
- "iso_code": "AW",
- "de": "Aruba"
}, - {
- "en": "Australia",
- "iso_code": "AU",
- "de": "Australien"
}, - {
- "en": "Austria",
- "iso_code": "AT",
- "de": "Österreich"
}, - {
- "en": "Azerbaijan",
- "iso_code": "AZ",
- "de": "Aserbaidschan"
}, - {
- "en": "Bahamas",
- "iso_code": "BS",
- "de": "Bahamas"
}, - {
- "en": "Bahrain",
- "iso_code": "BH",
- "de": "Bahrain"
}, - {
- "en": "Bangladesh",
- "iso_code": "BD",
- "de": "Bangladesch"
}, - {
- "en": "Barbados",
- "iso_code": "BB",
- "de": "Barbados"
}, - {
- "en": "Belarus",
- "iso_code": "BY",
- "de": "Weißrussland"
}, - {
- "en": "Belgium",
- "iso_code": "BE",
- "de": "Belgien"
}, - {
- "en": "Belize",
- "iso_code": "BZ",
- "de": "Belize"
}, - {
- "en": "Benin",
- "iso_code": "BJ",
- "de": "Benin"
}, - {
- "en": "Bermuda",
- "iso_code": "BM",
- "de": "Bermuda"
}, - {
- "en": "Bhutan",
- "iso_code": "BT",
- "de": "Bhutan"
}, - {
- "en": "Bolivia",
- "iso_code": "BO",
- "de": "Bolivien"
}, - {
- "en": "Bosnia and Herzegovina",
- "iso_code": "BA",
- "de": "Bosnien und Herzegowina"
}, - {
- "en": "Botswana",
- "iso_code": "BW",
- "de": "Botswana"
}, - {
- "en": "Bouvet Island",
- "iso_code": "BV",
- "de": "Bouvetinsel"
}, - {
- "en": "Brazil",
- "iso_code": "BR",
- "de": "Brasilien"
}, - {
- "en": "British Indian Ocean Territory",
- "iso_code": "IO",
- "de": "Britisches Territorium im Indischen Ozean"
}, - {
- "en": "Brunei Darussalam",
- "iso_code": "BN",
- "de": "Brunei"
}, - {
- "en": "Bulgaria",
- "iso_code": "BG",
- "de": "Bulgarien"
}, - {
- "en": "Burkina Faso",
- "iso_code": "BF",
- "de": "Burkina Faso"
}, - {
- "en": "Burundi",
- "iso_code": "BI",
- "de": "Burundi"
}, - {
- "en": "Cambodia",
- "iso_code": "KH",
- "de": "Kambodscha"
}, - {
- "en": "Cameroon",
- "iso_code": "CM",
- "de": "Kamerun"
}, - {
- "en": "Canada",
- "iso_code": "CA",
- "de": "Kanada"
}, - {
- "en": "Cabo Verde",
- "iso_code": "CV",
- "de": "Kap Verde"
}, - {
- "en": "Cayman Islands",
- "iso_code": "KY",
- "de": "Cayman Islands (Kaimaninseln)"
}, - {
- "en": "Central African Republic",
- "iso_code": "CF",
- "de": "Zentralafrikanische Republik"
}, - {
- "en": "Chad",
- "iso_code": "TD",
- "de": "Tschad"
}, - {
- "en": "Chile",
- "iso_code": "CL",
- "de": "Chile"
}, - {
- "en": "China",
- "iso_code": "CN",
- "de": "Volksrepublik China"
}, - {
- "en": "Christmas Island",
- "iso_code": "CX",
- "de": "Weihnachtsinsel"
}, - {
- "en": "Cocos (Keeling) Islands",
- "iso_code": "CC",
- "de": "Kokosinseln"
}, - {
- "en": "Colombia",
- "iso_code": "CO",
- "de": "Kolumbien"
}, - {
- "en": "Comoros",
- "iso_code": "KM",
- "de": "Komoren"
}, - {
- "en": "Congo",
- "iso_code": "CG",
- "de": "Republik Kongo"
}, - {
- "en": "Democratic Republic of the Congo",
- "iso_code": "CD",
- "de": "Demokratische Republik Kongo"
}, - {
- "en": "Cook Islands",
- "iso_code": "CK",
- "de": "Cookinseln"
}, - {
- "en": "Costa Rica",
- "iso_code": "CR",
- "de": "Costa Rica"
}, - {
- "en": "Croatia",
- "iso_code": "HR",
- "de": "Kroatien"
}, - {
- "en": "Cuba",
- "iso_code": "CU",
- "de": "Kuba"
}, - {
- "en": "Cyprus",
- "iso_code": "CY",
- "de": "Zypern"
}, - {
- "en": "Czechia",
- "iso_code": "CZ",
- "de": "Tschechien"
}, - {
- "en": "Denmark",
- "iso_code": "DK",
- "de": "Dänemark"
}, - {
- "en": "Djibouti",
- "iso_code": "DJ",
- "de": "Dschibuti"
}, - {
- "en": "Dominica",
- "iso_code": "DM",
- "de": "Dominica"
}, - {
- "en": "Dominican Republic",
- "iso_code": "DO",
- "de": "Dominikanische Republik"
}, - {
- "en": "Ecuador",
- "iso_code": "EC",
- "de": "Ecuador"
}, - {
- "en": "Egypt",
- "iso_code": "EG",
- "de": "Ägypten"
}, - {
- "en": "El Salvador",
- "iso_code": "SV",
- "de": "El Salvador"
}, - {
- "en": "Equatorial Guinea",
- "iso_code": "GQ",
- "de": "Äquatorialguinea"
}, - {
- "en": "Eritrea",
- "iso_code": "ER",
- "de": "Eritrea"
}, - {
- "en": "Estonia",
- "iso_code": "EE",
- "de": "Estland"
}, - {
- "en": "Ethiopia",
- "iso_code": "ET",
- "de": "Äthiopien"
}, - {
- "en": "Falkland Islands (Malvinas)",
- "iso_code": "FK",
- "de": "Falklandinseln"
}, - {
- "en": "Faroe Islands",
- "iso_code": "FO",
- "de": "Färöer"
}, - {
- "en": "Fiji",
- "iso_code": "FJ",
- "de": "Fidschi"
}, - {
- "en": "Finland",
- "iso_code": "FI",
- "de": "Finnland"
}, - {
- "en": "France",
- "iso_code": "FR",
- "de": "Frankreich"
}, - {
- "en": "French Guiana",
- "iso_code": "GF",
- "de": "Französisch-Guayana"
}, - {
- "en": "French Polynesia",
- "iso_code": "PF",
- "de": "Französisch-Polynesien"
}, - {
- "en": "French Southern Territories",
- "iso_code": "TF",
- "de": "Französische Süd- und Antarktisgebiete"
}, - {
- "en": "Gabon",
- "iso_code": "GA",
- "de": "Gabun"
}, - {
- "en": "Gambia",
- "iso_code": "GM",
- "de": "Gambia"
}, - {
- "en": "Georgia",
- "iso_code": "GE",
- "de": "Georgien"
}, - {
- "en": "Germany",
- "iso_code": "DE",
- "de": "Deutschland"
}, - {
- "en": "Ghana",
- "iso_code": "GH",
- "de": "Ghana"
}, - {
- "en": "Gibraltar",
- "iso_code": "GI",
- "de": "Gibraltar"
}, - {
- "en": "Greece",
- "iso_code": "GR",
- "de": "Griechenland"
}, - {
- "en": "Greenland",
- "iso_code": "GL",
- "de": "Grönland"
}, - {
- "en": "Grenada",
- "iso_code": "GD",
- "de": "Grenada"
}, - {
- "en": "Guadeloupe",
- "iso_code": "GP",
- "de": "Guadeloupe"
}, - {
- "en": "Guam",
- "iso_code": "GU",
- "de": "Guam"
}, - {
- "en": "Guatemala",
- "iso_code": "GT",
- "de": "Guatemala"
}, - {
- "en": "Guernsey",
- "iso_code": "GG",
- "de": "Guernsey (Kanalinsel)"
}, - {
- "en": "Guinea",
- "iso_code": "GN",
- "de": "Guinea"
}, - {
- "en": "Guinea-Bissau",
- "iso_code": "GW",
- "de": "Guinea-Bissau"
}, - {
- "en": "Guyana",
- "iso_code": "GY",
- "de": "Guyana"
}, - {
- "en": "Haiti",
- "iso_code": "HT",
- "de": "Haiti"
}, - {
- "en": "Heard Island and McDonald Islands",
- "iso_code": "HM",
- "de": "Heard und McDonaldinseln"
}, - {
- "en": "Vatican City (Holy See)",
- "iso_code": "VA",
- "de": "Vatikanstadt"
}, - {
- "en": "Honduras",
- "iso_code": "HN",
- "de": "Honduras"
}, - {
- "en": "Hong Kong",
- "iso_code": "HK",
- "de": "Hongkong"
}, - {
- "en": "Hungary",
- "iso_code": "HU",
- "de": "Ungarn"
}, - {
- "en": "Iceland",
- "iso_code": "IS",
- "de": "Island"
}, - {
- "en": "India",
- "iso_code": "IN",
- "de": "Indien"
}, - {
- "en": "Indonesia",
- "iso_code": "ID",
- "de": "Indonesien"
}, - {
- "en": "Iran",
- "iso_code": "IR",
- "de": "Iran"
}, - {
- "en": "Iraq",
- "iso_code": "IQ",
- "de": "Irak"
}, - {
- "en": "Ireland",
- "iso_code": "IE",
- "de": "Irland"
}, - {
- "en": "Isle of Man",
- "iso_code": "IM",
- "de": "Isle of Man"
}, - {
- "en": "Israel",
- "iso_code": "IL",
- "de": "Israel"
}, - {
- "en": "Italy",
- "iso_code": "IT",
- "de": "Italien"
}, - {
- "en": "Jamaica",
- "iso_code": "JM",
- "de": "Jamaika"
}, - {
- "en": "Japan",
- "iso_code": "JP",
- "de": "Japan"
}, - {
- "en": "Jersey",
- "iso_code": "JE",
- "de": "Jersey (Kanalinsel)"
}, - {
- "en": "Jordan",
- "iso_code": "JO",
- "de": "Jordanien"
}, - {
- "en": "Kazakhstan",
- "iso_code": "KZ",
- "de": "Kasachstan"
}, - {
- "en": "Kenya",
- "iso_code": "KE",
- "de": "Kenia"
}, - {
- "en": "Kiribati",
- "iso_code": "KI",
- "de": "Kiribati"
}, - {
- "en": "Democratic People's Republic of Korea",
- "iso_code": "KP",
- "de": "Nordkorea"
}, - {
- "en": "South Korea",
- "iso_code": "KR",
- "de": "Südkorea"
}, - {
- "en": "Kuwait",
- "iso_code": "KW",
- "de": "Kuwait"
}, - {
- "en": "Kyrgyzstan",
- "iso_code": "KG",
- "de": "Kirgisistan"
}, - {
- "en": "Lao People's Democratic Republic",
- "iso_code": "LA",
- "de": "Laos"
}, - {
- "en": "Latvia",
- "iso_code": "LV",
- "de": "Lettland"
}, - {
- "en": "Lebanon",
- "iso_code": "LB",
- "de": "Libanon"
}, - {
- "en": "Lesotho",
- "iso_code": "LS",
- "de": "Lesotho"
}, - {
- "en": "Liberia",
- "iso_code": "LR",
- "de": "Liberia"
}, - {
- "en": "Libya",
- "iso_code": "LY",
- "de": "Libyen"
}, - {
- "en": "Liechtenstein",
- "iso_code": "LI",
- "de": "Liechtenstein"
}, - {
- "en": "Lithuania",
- "iso_code": "LT",
- "de": "Litauen"
}, - {
- "en": "Luxembourg",
- "iso_code": "LU",
- "de": "Luxemburg"
}, - {
- "en": "Macao",
- "iso_code": "MO",
- "de": "Macau"
}, - {
- "en": "North Macedonia",
- "iso_code": "MK",
- "de": "Nordmazedonien"
}, - {
- "en": "Madagascar",
- "iso_code": "MG",
- "de": "Madagaskar"
}, - {
- "en": "Malawi",
- "iso_code": "MW",
- "de": "Malawi"
}, - {
- "en": "Malaysia",
- "iso_code": "MY",
- "de": "Malaysia"
}, - {
- "en": "Maldives",
- "iso_code": "MV",
- "de": "Malediven"
}, - {
- "en": "Mali",
- "iso_code": "ML",
- "de": "Mali"
}, - {
- "en": "Malta",
- "iso_code": "MT",
- "de": "Malta"
}, - {
- "en": "Marshall Islands",
- "iso_code": "MH",
- "de": "Marshallinseln"
}, - {
- "en": "Martinique",
- "iso_code": "MQ",
- "de": "Martinique"
}, - {
- "en": "Mauritania",
- "iso_code": "MR",
- "de": "Mauretanien"
}, - {
- "en": "Mauritius",
- "iso_code": "MU",
- "de": "Mauritius"
}, - {
- "en": "Mayotte",
- "iso_code": "YT",
- "de": "Mayotte"
}, - {
- "en": "Mexico",
- "iso_code": "MX",
- "de": "Mexiko"
}, - {
- "en": "Micronesia (Federated States of)",
- "iso_code": "FM",
- "de": "Mikronesien"
}, - {
- "en": "Moldova",
- "iso_code": "MD",
- "de": "Moldau (Moldawien)"
}, - {
- "en": "Monaco",
- "iso_code": "MC",
- "de": "Monaco"
}, - {
- "en": "Mongolia",
- "iso_code": "MN",
- "de": "Mongolei"
}, - {
- "en": "Montenegro",
- "iso_code": "ME",
- "de": "Montenegro"
}, - {
- "en": "Montserrat",
- "iso_code": "MS",
- "de": "Montserrat"
}, - {
- "en": "Morocco",
- "iso_code": "MA",
- "de": "Marokko"
}, - {
- "en": "Mozambique",
- "iso_code": "MZ",
- "de": "Mosambik"
}, - {
- "en": "Myanmar",
- "iso_code": "MM",
- "de": "Myanmar (Burma)"
}, - {
- "en": "Namibia",
- "iso_code": "NA",
- "de": "Namibia"
}, - {
- "en": "Nauru",
- "iso_code": "NR",
- "de": "Nauru"
}, - {
- "en": "Nepal",
- "iso_code": "NP",
- "de": "Nepal"
}, - {
- "en": "Netherlands",
- "iso_code": "NL",
- "de": "Niederlande"
}, - {
- "en": "Netherlands Antilles",
- "iso_code": "AN",
- "de": "Niederländische Antillen"
}, - {
- "en": "New Caledonia",
- "iso_code": "NC",
- "de": "Neukaledonien"
}, - {
- "en": "New Zealand",
- "iso_code": "NZ",
- "de": "Neuseeland"
}, - {
- "en": "Nicaragua",
- "iso_code": "NI",
- "de": "Nicaragua"
}, - {
- "en": "Niger",
- "iso_code": "NE",
- "de": "Niger"
}, - {
- "en": "Nigeria",
- "iso_code": "NG",
- "de": "Nigeria"
}, - {
- "en": "Niue",
- "iso_code": "NU",
- "de": "Niue"
}, - {
- "en": "Norfolk Island",
- "iso_code": "NF",
- "de": "Norfolkinsel"
}, - {
- "en": "Northern Mariana Islands",
- "iso_code": "MP",
- "de": "Nördliche Marianen"
}, - {
- "en": "Norway",
- "iso_code": "NO",
- "de": "Norwegen"
}, - {
- "en": "Oman",
- "iso_code": "OM",
- "de": "Oman"
}, - {
- "en": "Pakistan",
- "iso_code": "PK",
- "de": "Pakistan"
}, - {
- "en": "Palau",
- "iso_code": "PW",
- "de": "Palau"
}, - {
- "en": "State of Palestine",
- "iso_code": "PS",
- "de": "Palästina"
}, - {
- "en": "Panama",
- "iso_code": "PA",
- "de": "Panama"
}, - {
- "en": "Papua New Guinea",
- "iso_code": "PG",
- "de": "Papua-Neuguinea"
}, - {
- "en": "Paraguay",
- "iso_code": "PY",
- "de": "Paraguay"
}, - {
- "en": "Peru",
- "iso_code": "PE",
- "de": "Peru"
}, - {
- "en": "Philippines",
- "iso_code": "PH",
- "de": "Philippinen"
}, - {
- "en": "Pitcairn",
- "iso_code": "PN",
- "de": "Pitcairninseln"
}, - {
- "en": "Poland",
- "iso_code": "PL",
- "de": "Polen"
}, - {
- "en": "Portugal",
- "iso_code": "PT",
- "de": "Portugal"
}, - {
- "en": "Puerto Rico",
- "iso_code": "PR",
- "de": "Puerto Rico"
}, - {
- "en": "Qatar",
- "iso_code": "QA",
- "de": "Katar"
}, - {
- "en": "Réunion",
- "iso_code": "RE",
- "de": "Réunion"
}, - {
- "en": "Romania",
- "iso_code": "RO",
- "de": "Rumänien"
}, - {
- "en": "Russian Federation",
- "iso_code": "RU",
- "de": "Russland"
}, - {
- "en": "Rwanda",
- "iso_code": "RW",
- "de": "Ruanda"
}, - {
- "en": "Saint Helena, Ascension and Tristan da Cunha",
- "iso_code": "SH",
- "de": "St. Helena, Ascension und Tristan da Cunha"
}, - {
- "en": "Saint Kitts and Nevis",
- "iso_code": "KN",
- "de": "St. Kitts und Nevis"
}, - {
- "en": "Saint Lucia",
- "iso_code": "LC",
- "de": "St. Lucia"
}, - {
- "en": "Saint Martin (French part)",
- "iso_code": "MF",
- "de": "Saint-Martin (französischer Teil)"
}, - {
- "en": "Saint Pierre and Miquelon",
- "iso_code": "PM",
- "de": "Saint-Pierre und Miquelon"
}, - {
- "en": "Saint Vincent and the Grenadines",
- "iso_code": "VC",
- "de": "St. Vincent und die Grenadinen"
}, - {
- "en": "Samoa",
- "iso_code": "WS",
- "de": "Samoa"
}, - {
- "en": "San Marino",
- "iso_code": "SM",
- "de": "San Marino"
}, - {
- "en": "Sao Tome and Principe",
- "iso_code": "ST",
- "de": "São Tomé und Príncipe"
}, - {
- "en": "Saudi Arabia",
- "iso_code": "SA",
- "de": "Saudi-Arabien"
}, - {
- "en": "Senegal",
- "iso_code": "SN",
- "de": "Senegal"
}, - {
- "en": "Serbia",
- "iso_code": "RS",
- "de": "Serbien"
}, - {
- "en": "Seychelles",
- "iso_code": "SC",
- "de": "Seychellen"
}, - {
- "en": "Sierra Leone",
- "iso_code": "SL",
- "de": "Sierra Leone"
}, - {
- "en": "Singapore",
- "iso_code": "SG",
- "de": "Singapur"
}, - {
- "en": "Slovakia",
- "iso_code": "SK",
- "de": "Slowakei"
}, - {
- "en": "Slovenia",
- "iso_code": "SI",
- "de": "Slowenien"
}, - {
- "en": "Solomon Islands",
- "iso_code": "SB",
- "de": "Salomonen"
}, - {
- "en": "Somalia",
- "iso_code": "SO",
- "de": "Somalia"
}, - {
- "en": "South Africa",
- "iso_code": "ZA",
- "de": "Südafrika"
}, - {
- "en": "South Georgia and the South Sandwich Islands",
- "iso_code": "GS",
- "de": "Südgeorgien und die Südlichen Sandwichinseln"
}, - {
- "en": "Spain",
- "iso_code": "ES",
- "de": "Spanien"
}, - {
- "en": "Sri Lanka",
- "iso_code": "LK",
- "de": "Sri Lanka"
}, - {
- "en": "Sudan",
- "iso_code": "SD",
- "de": "Sudan"
}, - {
- "en": "Suriname",
- "iso_code": "SR",
- "de": "Suriname"
}, - {
- "en": "Svalbard and Jan Mayen",
- "iso_code": "SJ",
- "de": "Spitzbergen und Jan Mayen"
}, - {
- "en": "Eswatini",
- "iso_code": "SZ",
- "de": "Eswatini"
}, - {
- "en": "Sweden",
- "iso_code": "SE",
- "de": "Schweden"
}, - {
- "en": "Switzerland",
- "iso_code": "CH",
- "de": "Schweiz"
}, - {
- "en": "Syrian Arab Republic",
- "iso_code": "SY",
- "de": "Syrien"
}, - {
- "en": "Taiwan",
- "iso_code": "TW",
- "de": "Taiwan"
}, - {
- "en": "Tajikistan",
- "iso_code": "TJ",
- "de": "Tadschikistan"
}, - {
- "en": "Tanzania",
- "iso_code": "TZ",
- "de": "Tansania"
}, - {
- "en": "Thailand",
- "iso_code": "TH",
- "de": "Thailand"
}, - {
- "en": "Timor-Leste",
- "iso_code": "TL",
- "de": "Osttimor (Timor-Leste)"
}, - {
- "en": "Togo",
- "iso_code": "TG",
- "de": "Togo"
}, - {
- "en": "Tokelau",
- "iso_code": "TK",
- "de": "Tokelau"
}, - {
- "en": "Tonga",
- "iso_code": "TO",
- "de": "Tonga"
}, - {
- "en": "Trinidad and Tobago",
- "iso_code": "TT",
- "de": "Trinidad und Tobago"
}, - {
- "en": "Tunisia",
- "iso_code": "TN",
- "de": "Tunesien"
}, - {
- "en": "Türkiye",
- "iso_code": "TR",
- "de": "Türkei"
}, - {
- "en": "Turkmenistan",
- "iso_code": "TM",
- "de": "Turkmenistan"
}, - {
- "en": "Turks and Caicos Islands",
- "iso_code": "TC",
- "de": "Turks- und Caicosinseln"
}, - {
- "en": "Tuvalu",
- "iso_code": "TV",
- "de": "Tuvalu"
}, - {
- "en": "Uganda",
- "iso_code": "UG",
- "de": "Uganda"
}, - {
- "en": "Ukraine",
- "iso_code": "UA",
- "de": "Ukraine"
}, - {
- "en": "United Arab Emirates",
- "iso_code": "AE",
- "de": "Vereinigte Arabische Emirate"
}, - {
- "en": "United Kingdom (UK)",
- "iso_code": "GB",
- "de": "Vereinigtes Königreich (UK)"
}, - {
- "en": "United States of America",
- "iso_code": "US",
- "de": "Vereinigte Staaten von Amerika"
}, - {
- "en": "United States Minor Outlying Islands",
- "iso_code": "UM",
- "de": "United States Minor Outlying Islands"
}, - {
- "en": "Uruguay",
- "iso_code": "UY",
- "de": "Uruguay"
}, - {
- "en": "Uzbekistan",
- "iso_code": "UZ",
- "de": "Usbekistan"
}, - {
- "en": "Vanuatu",
- "iso_code": "VU",
- "de": "Vanuatu"
}, - {
- "en": "Venezuela (Bolivarian Republic of)",
- "iso_code": "VE",
- "de": "Venezuela"
}, - {
- "en": "Vietnam",
- "iso_code": "VN",
- "de": "Vietnam"
}, - {
- "en": "Virgin Islands (British)",
- "iso_code": "VG",
- "de": "Britische Jungferninseln"
}, - {
- "en": "Virgin Islands (U.S.)",
- "iso_code": "VI",
- "de": "Amerikanische Jungferninseln"
}, - {
- "en": "Wallis and Futuna",
- "iso_code": "WF",
- "de": "Wallis und Futuna"
}, - {
- "en": "Western Sahara",
- "iso_code": "EH",
- "de": "Westsahara"
}, - {
- "en": "Yemen",
- "iso_code": "YE",
- "de": "Jemen"
}, - {
- "en": "Zambia",
- "iso_code": "ZM",
- "de": "Sambia"
}, - {
- "en": "Zimbabwe",
- "iso_code": "ZW",
- "de": "Simbabwe"
}, - {
- "en": "Côte d'Ivoire",
- "iso_code": "CI",
- "de": "Elfenbeinküste (Côte d’Ivoire)"
}, - {
- "en": "Curaçao",
- "iso_code": "CW",
- "de": "Curaçao"
}, - {
- "en": "Sint Maarten (Dutch part)",
- "iso_code": "SX",
- "de": "Sint Maarten"
}, - {
- "en": "Kosovo",
- "iso_code": "XK",
- "de": "Kosovo"
}, - {
- "en": "Åland Islands",
- "iso_code": "AX",
- "de": "Åland"
}, - {
- "en": "Bonaire, Sint Eustatius and Saba",
- "iso_code": "BQ",
- "de": "Bonaire, Saba, Sint Eustatius"
}, - {
- "en": "Saint Barthélemy",
- "iso_code": "BL",
- "de": "Saint-Barthélemy"
}, - {
- "en": "South Sudan",
- "iso_code": "SS",
- "de": "Südsudan"
}, - {
- "en": "stateless",
- "iso_code": "XX",
- "de": "staatenlos"
}
]