{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Payment provider compatibility","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":"payment-provider-compatibility","__idx":0},"children":["Payment provider compatibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use an available card Payment Account Reference (PAR) or full customer IBAN"," ","for automatic receipt delivery. Include last four card digits in the encrypted"," ","receipt when available, and offer the enabled web wallet link when no customer"," ","matches."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Identifier availability depends on the provider, payment method, channel,"," ","account settings, and individual transaction. A terminal model alone does not"," ","establish which identifiers your integration receives. A debit card payment"," ","does not by itself mean the provider exposes the customer's IBAN."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-a-matching-path","__idx":1},"children":["Choose a matching path"]},{"$$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":"Identifier"},"children":["Identifier"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"How it is used"},"children":["How it is used"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Where to send it"},"children":["Where to send it"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card PAR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automatic matching to a Cheqi user during recipient resolution"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IdentificationDetails.cardDetails.paymentAccountReference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full customer IBAN"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automatic matching to a Cheqi user during recipient resolution"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IdentificationDetails.paymentAccountDetails.identifier"]},", with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountIdentifierType: \"IBAN\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last four card digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receipt payment metadata; cannot identify a customer at checkout"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Encrypted ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceiptPayload.paymentDetails.cardLastFour"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PAR and IBAN delivery require a successful"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/recipient-resolution"},"children":["recipient match"]},". Four digits alone cannot identify"," ","a customer at checkout."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"provider-coverage","__idx":2},"children":["Provider coverage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Availability varies by account and transaction. Confirm the required fields"," ","with your provider and test your integration. This table does not certify"," ","terminal models; unverified coverage is identified below."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"card-payments-par","__idx":3},"children":["Card payments: PAR"]},{"$$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":"Provider and channel"},"children":["Provider and channel"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"PAR availability"},"children":["PAR availability"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required action or limitation"},"children":["Required action or limitation"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/adyen"},"children":["Adyen"]}," terminals (Terminal API)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available when enabled, if supplied for the transaction"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enable PAR in the Adyen Customer Area."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/adyen"},"children":["Adyen"]}," online cards"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available when enabled, if supplied for the transaction"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enable PAR in Additional data and in standard webhooks when using that path."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stripe Terminal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request account enablement"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/stripe-par"},"children":["Enable PAR in Stripe"]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_present"]}," payments."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stripe online cards"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request account enablement"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/stripe-par"},"children":["Enable PAR in Stripe"]},", including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charge.updated"]}," events for later PAR updates."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/mollie"},"children":["Mollie"]}," terminals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unverified with a live payment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the card fingerprint only when it contains a valid PAR."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/mollie"},"children":["Mollie"]}," online cards"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Current availability unverified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm current PAR availability with Mollie before relying on card matching."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/worldline"},"children":["Worldline"]}," terminals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unknown for the terminal integration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm PAR availability for your specific Worldline product and API."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/worldline"},"children":["Worldline"]}," online cards"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read when supplied by the integrated online API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read PAR from the payment, retrieving it when missing from the callback."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"bank-payments-iban","__idx":4},"children":["Bank payments: IBAN"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the customer's full IBAN returned for the payment. A masked IBAN, an IBAN"," ","suffix, a domestic account number, or the merchant's receiving account must"," ","not be supplied as the customer's full IBAN."]},{"$$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":"Provider and payment flow"},"children":["Provider and payment flow"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Full customer IBAN availability"},"children":["Full customer IBAN availability"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required action or limitation"},"children":["Required action or limitation"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/adyen#full-iban-for-bank-payments"},"children":["Adyen"]}," online bank payments, such as iDEAL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used when returned for the account and payment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask Adyen to include customer bank details if they are missing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/mollie#full-iban-for-bank-payments"},"children":["Mollie"]}," online bank payments, such as iDEAL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.consumerAccount"]}," contains a full IBAN"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate the account type; this field can contain other account references."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/worldline#full-iban-for-bank-payments"},"children":["Worldline"]}," online redirect bank payments, such as iDEAL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used when the integrated online API returns a full IBAN"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve the payment when the callback omits bank details. Availability depends on the product and payment method."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/stripe-par#full-iban-for-bank-payments"},"children":["Stripe"]}," online bank payments, including iDEAL and SEPA Direct Debit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Suffix-only responses cannot support full-IBAN matching"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use another matching identifier or offer the QR receipt. PAR enablement does not establish IBAN availability."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify full-IBAN availability for your account and payment method. IBAN"," ","availability for in-store terminal payments is not verified here."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["“Unknown” and “unverified” do not mean a provider cannot expose the identifier. An"," ","unavailable status applies only to the specific product, channel, or test"," ","described."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For other providers or payment methods, confirm which customer identifiers the"," ","API exposes, whether account enablement is needed, and when the identifiers"," ","become available."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qr-collection-with-the-last-four-card-digits","__idx":5},"children":["QR collection with the last four card digits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adyen, Stripe, Mollie, and Worldline support last-four card details for card"," ","payments. This gives your integration a QR collection path even when PAR is"," ","missing or automatic matching finds no customer."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the last four card digits in the definitive encrypted receipt's"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentDetails.cardLastFour"]}," field. For example, this fragment belongs in"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceiptPayload"]}," before encryption:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"paymentDetails\": {\n    \"cardLastFour\": \"4242\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Offer the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/qr-collection"},"children":["web wallet link"]}," as a QR code when download"," ","fallback is enabled."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The customer opens the link in their browser or collects the receipt in the"," ","Cheqi app. Checkout does not need to wait for collection."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not put last-four card digits in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IdentificationDetails.cardDetails"]}," or pass"," ","a provider-specific fingerprint as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentAccountReference"]},". The suffix"," ","belongs in the encrypted receipt."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-no-automatic-match-is-available","__idx":6},"children":["When no automatic match is available"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Continue recipient resolution with another appropriate identifier, such as a"," ","customer's pairing code, a supported payment-account identifier, or their Cheqi"," ","email address. If no customer matches and download fallback is enabled, offer"," ","the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/qr-collection"},"children":["web wallet link"]},", for example as a QR code at checkout."," ","If no delivery route is available, continue with your existing receipt process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a card payment without PAR or another reliable customer identifier, keep"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentType"]}," in the identification request and include the last four digits"," ","in the encrypted receipt as described above. An IBAN suffix is not a card"," ","suffix and must not be placed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardLastFour"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/recipient-resolution#card-payment-receipt-metadata"},"children":["card-payment receipt metadata"]}," ","and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/download-fallback"},"children":["Download Links"]}," for the fallback flow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"provider-guides","__idx":7},"children":["Provider guides"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The provider subpages contain setup instructions, response fields, and the"," ","availability limitations for each integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/adyen"},"children":["Adyen Payment Identifiers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/mollie"},"children":["Mollie Payment Identifiers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/stripe-par"},"children":["Enable PAR in Stripe"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/worldline"},"children":["Worldline Payment Identifiers"]}]}]}]},"headings":[{"value":"Payment provider compatibility","id":"payment-provider-compatibility","depth":1},{"value":"Choose a matching path","id":"choose-a-matching-path","depth":2},{"value":"Provider coverage","id":"provider-coverage","depth":2},{"value":"Card payments: PAR","id":"card-payments-par","depth":3},{"value":"Bank payments: IBAN","id":"bank-payments-iban","depth":3},{"value":"QR collection with the last four card digits","id":"qr-collection-with-the-last-four-card-digits","depth":2},{"value":"When no automatic match is available","id":"when-no-automatic-match-is-available","depth":2},{"value":"Provider guides","id":"provider-guides","depth":2}],"frontmatter":{"title":"Payment Provider Compatibility","description":"Configure payment identifiers and receipt-link fallback by provider","seo":{"title":"Payment provider compatibility"}},"lastModified":"2026-11-11T02:05:48.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/receipts/payment-provider-compatibility","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}