{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Belgium ( BE )","description":"Complete documentation for integrating Cheqi's digital receipt platform","keywords":["cheqi","digital receipts","api","sdk","java","javascript"]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"belgium--be-","__idx":0},"children":["Belgium (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ordinary Belgian receipts and invoices use the canonical receipt fields and"," ","need no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]},". Use a GKS regime only when a registered"," ","cash-register flow actually applies."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cheqi does not calculate, invent, or validate GKS values. The POS completes the"," ","registered-system operation first and places the returned values in the slots"," ","below. The receipt engine preserves them in CHEQI JSON and references them in"," ","the generated UBL documents."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"legacy-gks","__idx":1},"children":["Legacy GKS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE_GKS"]}," for the legacy registered cash-register flow."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value supplied by the legacy system"},"children":["Value supplied by the legacy system"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cheqi request location"},"children":["Cheqi request location"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cash-register serial"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.cashRegisterId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal Data Module serial"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.fiscalDeviceId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal receipt number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.fiscalDocumentNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ticket/event sequence"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.sequenceNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal timestamp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.timestamp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Short authentication value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.verificationCode"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Opaque signature, when returned separately"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.signature"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VSC card identifier"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.additionalFields"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:VSC_ID"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required visible heading for a normal VAT ticket"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.legalTexts[]"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:GKS_DOCUMENT_HEADING"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["displayRole = DOCUMENT_HEADING"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exact printed control data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.additionalFields"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:CONTROL_DATA"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Machine-readable verification value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barcodes[]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"barcodes\": [\n    {\n      \"type\": \"QR_CODE\",\n      \"data\": \"<exact verification payload produced by the legacy system>\",\n      \"label\": \"GKS verification\"\n    }\n  ],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"BE\",\n    \"regime\": \"BE_GKS\",\n    \"regimeVersion\": \"2026-07\",\n    \"fiscalization\": {\n      \"system\": \"BE_GKS\",\n      \"status\": \"FISCALIZED\",\n      \"fiscalDocumentNumber\": \"<exact fiscal receipt number>\",\n      \"fiscalDeviceId\": \"<exact FDM serial>\",\n      \"cashRegisterId\": \"<exact cash-register serial>\",\n      \"sequenceNumber\": \"<exact ticket or event sequence>\",\n      \"verificationCode\": \"<exact authentication value>\",\n      \"signature\": \"<exact opaque signature, when supplied>\",\n      \"timestamp\": \"<exact fiscal timestamp>\"\n    },\n    \"legalTexts\": [\n      {\n        \"code\": \"BE:GKS_DOCUMENT_HEADING\",\n        \"text\": \"BTW-KASTICKET\",\n        \"languageCode\": \"nl-BE\",\n        \"displayRole\": \"DOCUMENT_HEADING\"\n      }\n    ],\n    \"additionalFields\": [\n      {\n        \"code\": \"BE:VSC_ID\",\n        \"value\": \"<exact VSC identifier>\"\n      },\n      {\n        \"code\": \"BE:CONTROL_DATA\",\n        \"value\": \"<exact control data printed by the system>\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a normal Dutch-language VAT ticket, supply ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BTW-KASTICKET"]},". For a normal"," ","French-language VAT ticket, replace that legal-text object with:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": \"BE:GKS_DOCUMENT_HEADING\",\n  \"text\": \"TICKET DE CAISSE T.V.A.\",\n  \"languageCode\": \"fr-BE\",\n  \"displayRole\": \"DOCUMENT_HEADING\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The merchant's registered POS must select and return the legally applicable"," ","language and document type. Cheqi preserves the supplied value; it does not"," ","translate it or decide that a normal VAT ticket applies. Omit optional"," ","properties that the legacy system does not return. Do not replace them with"," ","invented values."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"gks-20","__idx":2},"children":["GKS 2.0"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE_GKS_2"]}," after the GKS 2.0 POS has received a successful ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SignResult"]}," ","from the Fiscal Data Module."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"GKS 2.0 value"},"children":["GKS 2.0 value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cheqi request location"},"children":["Cheqi request location"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["posFiscalTicketNo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.fiscalDocumentNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["posId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.cashRegisterId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terminalId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.additionalFields"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:TERMINAL_ID"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.additionalFields"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:INPUT_DEVICE_ID"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fdmRef.fdmId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.fiscalDeviceId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fdmRef.fdmDateTime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.timestamp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fdmRef.eventLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.additionalFields"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:EVENT_LABEL"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fdmRef.eventCounter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.sequenceNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fdmRef.totalCounter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.additionalFields"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:TOTAL_COUNTER"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shortSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.verificationCode"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["digitalSignature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.signature"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature algorithm label, when supplied"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.signatureAlgorithm"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.verificationUrl"]}," and top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barcodes[]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required visible heading for a normal VAT ticket"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.legalTexts[]"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:GKS_DOCUMENT_HEADING"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["displayRole = DOCUMENT_HEADING"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ordered ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["footer[]"]}," lines"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.legalTexts[]"]},", one entry per line"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"barcodes\": [\n    {\n      \"type\": \"QR_CODE\",\n      \"data\": \"<exact verificationUrl returned by the FDM>\",\n      \"label\": \"GKS 2.0 verification\"\n    }\n  ],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"BE\",\n    \"regime\": \"BE_GKS_2\",\n    \"regimeVersion\": \"2026-07\",\n    \"fiscalization\": {\n      \"system\": \"BE_GKS_2\",\n      \"status\": \"FISCALIZED\",\n      \"fiscalDocumentNumber\": \"<exact posFiscalTicketNo>\",\n      \"fiscalDeviceId\": \"<exact fdmRef.fdmId>\",\n      \"cashRegisterId\": \"<exact posId>\",\n      \"sequenceNumber\": \"<exact fdmRef.eventCounter>\",\n      \"verificationCode\": \"<exact shortSignature>\",\n      \"signature\": \"<exact digitalSignature>\",\n      \"verificationUrl\": \"<exact verificationUrl>\",\n      \"timestamp\": \"<exact fdmRef.fdmDateTime>\"\n    },\n    \"legalTexts\": [\n      {\n        \"code\": \"BE:GKS_DOCUMENT_HEADING\",\n        \"text\": \"BTW-KASTICKET\",\n        \"languageCode\": \"nl-BE\",\n        \"displayRole\": \"DOCUMENT_HEADING\"\n      },\n      {\n        \"code\": \"BE:FDM_FOOTER_01\",\n        \"text\": \"<exact first footer line>\",\n        \"displayRole\": \"FOOTER\"\n      },\n      {\n        \"code\": \"BE:FDM_FOOTER_02\",\n        \"text\": \"<exact second footer line>\",\n        \"displayRole\": \"FOOTER\"\n      }\n    ],\n    \"additionalFields\": [\n      {\n        \"code\": \"BE:TERMINAL_ID\",\n        \"value\": \"<exact terminalId>\"\n      },\n      {\n        \"code\": \"BE:INPUT_DEVICE_ID\",\n        \"value\": \"<exact deviceId>\"\n      },\n      {\n        \"code\": \"BE:EVENT_LABEL\",\n        \"value\": \"<exact fdmRef.eventLabel>\"\n      },\n      {\n        \"code\": \"BE:TOTAL_COUNTER\",\n        \"value\": \"<exact fdmRef.totalCounter>\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The placeholders show placement only. Supply the values returned by the"," ","merchant's certified POS and FDM integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generated-cheqi-and-ubl-output","__idx":3},"children":["Generated CHEQI and UBL output"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The local engine preserves the heading in the generated CHEQI JSON:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"jurisdictionalData\": {\n    \"countryCode\": \"BE\",\n    \"regime\": \"BE_GKS\",\n    \"regimeVersion\": \"2026-07\",\n    \"legalTexts\": [\n      {\n        \"code\": \"BE:GKS_DOCUMENT_HEADING\",\n        \"text\": \"BTW-KASTICKET\",\n        \"languageCode\": \"nl-BE\",\n        \"displayRole\": \"DOCUMENT_HEADING\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["UBL Invoice and UBL PurchaseReceipt carry the same exact value in Cheqi's"," ","structured UBL extension:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"xml","header":{"controls":{"copy":{}}},"source":"<ext:UBLExtensions>\n  <ext:UBLExtension>\n    <ext:ExtensionAgencyID>CHEQI</ext:ExtensionAgencyID>\n    <ext:ExtensionVersionID>1</ext:ExtensionVersionID>\n    <ext:ExtensionURI>urn:cheqi:ubl:extension:jurisdictional-legal-text:1</ext:ExtensionURI>\n    <ext:ExtensionContent>\n      <cheqi:JurisdictionalLegalTexts>\n        <cheqi:LegalText\n            code=\"BE:GKS_DOCUMENT_HEADING\"\n            displayRole=\"DOCUMENT_HEADING\"\n            languageCode=\"nl-BE\">BTW-KASTICKET</cheqi:LegalText>\n      </cheqi:JurisdictionalLegalTexts>\n    </ext:ExtensionContent>\n  </ext:UBLExtension>\n</ext:UBLExtensions>\n","lang":"xml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The document root declares:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"xml","header":{"controls":{"copy":{}}},"source":"xmlns:ext=\"urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2\"\nxmlns:cheqi=\"urn:cheqi:ubl:extension:components:1\"\n","lang":"xml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This heading is not written to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cbc:Note"]},". That element stays available for the"," ","free receipt message configured by the merchant in the Cheqi app, such as a"," ","thank-you or return message. It is not part of the receipt payload."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"merchant-id-and-terminal-id-on-card-receipts","__idx":4},"children":["Merchant ID and terminal ID on card receipts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card-payment slips often also show a merchant ID and terminal ID. Those are"," ","payment-acquirer identifiers, not Belgian GKS identifiers:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the acquirer merchant ID identifies the merchant account at the card"," ","processor"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the acquirer terminal ID identifies the payment terminal or acquiring"," ","endpoint"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supply them in the encrypted ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceiptPayload.paymentDetails"]}," so the device can"," ","include them in generated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMeans"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"paymentDetails\": {\n    \"paymentMeansCode\": \"48\",\n    \"cardProvider\": \"<card scheme>\",\n    \"cardLastFour\": \"<last four digits>\",\n    \"merchantId\": \"<exact MID from the payment integration>\",\n    \"paymentTerminalId\": \"<exact TID from the payment integration>\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is a fragment of the definitive receipt payload, not the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IdentificationDetails"]}," matching request. If PAR is unavailable, keep"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardLastFour"]}," in this encrypted object when sharing a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/qr-collection"},"children":["web wallet link"]},";"," ","the four digits alone do not identify a customer during merchant matching."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["They appear in the generated CHEQI receipt as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMeans.merchantId"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMeans.paymentTerminalId"]},". In UBL PurchaseReceipt they map to"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cac:Payment/cbc:MerchantID"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cac:Payment/cbc:PaymentTerminalID"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not put a card-payment terminal ID in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE:TERMINAL_ID"]},". The latter is the GKS"," ","fiscal POS ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terminalId"]},". Likewise, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cashRegisterId"]}," identifies the fiscal POS"," ","and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalDeviceId"]}," identifies the FDM."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For an ordinary receipt, omit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]},". Do not attach GKS evidence"," ","unless the merchant system actually produced it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":5},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/jurisdictional-data"},"children":["Supplying jurisdiction data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/recipient-resolution"},"children":["Recipient resolution"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/overview"},"children":["Country support boundary"]}]}]}]},"headings":[{"value":"Belgium ( BE )","id":"belgium--be-","depth":1},{"value":"Legacy GKS","id":"legacy-gks","depth":2},{"value":"GKS 2.0","id":"gks-20","depth":2},{"value":"Generated CHEQI and UBL output","id":"generated-cheqi-and-ubl-output","depth":2},{"value":"Merchant ID and terminal ID on card receipts","id":"merchant-id-and-terminal-id-on-card-receipts","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Belgium","description":"Supply legacy GKS and GKS 2.0 values without asking Cheqi to calculate them","seo":{"title":"Belgium ( BE )"}},"lastModified":"2026-10-12T22:15:07.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/be","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}