{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml","oas-apis/merchant-payment.openapi.yaml":"oas-apis/merchant-payment.openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","json-schema","openapi-code-sample"]},"type":"markdown"},"seo":{"title":"Static QR Code","description":"Discover the API documentation to start developing your Bancontact Pro application","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"New payment URLs"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Following the decommissioning of the Payconiq brand in Belgium, these URL changes are essential to ensure compliance and"," ","mark the final phase in aligning our branding with the new Bancontact Pro identity."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please implement adaptations ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/general/payloadurlupdate"},"children":["described here"]}," promptly to avoid service interruptions and guarantee the continued acceptance of mobile payments via Bancontact Pay and Wero."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Changes are already available in our pre-production environement and will be rolled out in production starting ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["11/05/2026"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"static-qr-code","__idx":0},"children":["Static QR Code"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":1},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Static QR Code allows you to add a printed static QR code to your point of sale (PoS) and link it to your cash register system."," ","Your PoS sends the payment information to the QR code, your consumers scan the QR code with their preferred payment application and confirm the transaction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"process-flow","__idx":2},"children":["Process Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following section outlines the key steps involved in a Static QR Code payment with Bancontact Pro API. The process involves several key parties, each playing a specific role in completing the transaction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prerequisites","__idx":3},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Key"]}," – This is used to secure the request between the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant’s backend"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact Pro’s backend"]},". Do not share your API keys in public areas such as online sites or client-side code."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant CallbackUrl"]}," (",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Optional"]},") – This URL will be called by Bancontact Pro’s backend servers in order to send the status of the payment to the merchant."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"involved-parties","__idx":4},"children":["Involved Parties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following parties participate in a display-based in-store payment with Bancontact :"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer Application"]},": The consumer's preferred payment app used to complete the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Frontend"]},": The printed static QR code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Backend"]},": The merchant’s server-side system that integrates with Bancontact ."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact  Backend"]},": The backend system responsible for handling payment processing and integration services."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-by-step-payment-flow","__idx":5},"children":["Step-by-Step Payment Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section outlines a typical ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["“Static QR Code”"]}," in-store payment flow using Bancontact . The process begins when the transaction is initiated at the merchant’s location and ends when both the merchant and the consumer receive the final confirmation."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant frontend"]}," displays a Static QR code, visible to the consumers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant backend"]}," issues a REST request to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]}," to create the payment, providing parameters like amount, currency, description, and other relevant parameters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]}," responds with the created payment ID and other relevant detail to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant backend"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer app"]}," scans the QR code to initiate the payment process."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer app"]}," sends a request for payment details to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]},". The POS ID present in the Static QR is matched with a POS ID on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]}," sends the payment details tot he ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer App"]},", which contains the name of the merchant and the amount to pay."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The consumer confirms the payment n the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer app"]}," using PIN, fingerprint, or face ID. The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer app"]}," then submits the payment request to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]}," for authorization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A payment response is sent back by the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]}," to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payer App"]},", indicating whether the payment was successful or failed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]}," sends a payment notification with the payment status to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant backend"]}," via the configured callback URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant frontend"]}," displays the payment  status."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important Note:"]}," The order in which the merchant and consumer receive payment status notifications is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not guaranteed"]},". Network and connectivity differences may cause one party to receive the update before the other."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-flow-diagram","__idx":6},"children":["Payment Flow Diagram"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following diagrams you will find a visual overview of the process flows presented above:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/staticqr2x.9f89c2ca2ac3d1d99a8d8d8fa9110d41405a26f742faa60f7c07cb614f716c71.85e0cfdd.jpg","alt":"Visualized diagram of the Static QR payment flow"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"implementation-guide","__idx":7},"children":["Implementation Guide"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full endpoint documentation, please refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/merchant-payment.openapi"},"children":["Merchant Payment API"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-create-a-static-qr-code","__idx":8},"children":["1. Create a Static QR Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In order to create a Static QR code you need to use the Bancontact  service URL as illustrated below. Once created, you will be able to print the Static QR on the medium of your choice."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"static-qr-code-parameters","__idx":9},"children":["Static QR Code Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The QR code contains the following parameters:"]},{"$$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":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["f"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"[String :: Enum] ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Allowed Values: SVG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Image format. If not provided, the default format is PNG."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["s"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"[String :: Enum] ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Allowed Values: S, M, L, XL",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Image size of the QR code to generate. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Small (S) = 180x180 ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Medium (M) = 250x250",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Large (L) = 400x400 ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Extra Large (XL) = 800x800 ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The sizes only applies to PNG format. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," *If not provided, the default size is Small."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["c"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," [String, required]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The  UTF-8 URL encoded content. This is comprised of the location URL scheme."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"static-qr-code-creation-process","__idx":10},"children":["Static QR Code creation process"]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%"}},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"style":{"textAlign":"left","width":"50%"}},"children":["Activity"]},{"$$mdtype":"Tag","name":"th","attributes":{"style":{"textAlign":"left","width":"50%"}},"children":["Comment"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1."]}," Obtain the pre-requisite information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\n        • Format of the  QR code.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        • Size of the  QR code.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        • Location URL scheme.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        • Payment profile ID of the merchant.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        • POS ID.\n      "]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2."]}," Build the  service URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\n        Sample format:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://qrcodegenerator.api.bancontact.net/qrcode?f={imageFormat}&s={ImageSize}&c="]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        Example Output URL (PNG):",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://qrcodegenerator.api.bancontact.net/qrcode?f=PNG&s=L&c="]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        Sample URL (SVG):",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://qrcodegenerator.api.bancontact.net/qrcode?f=SVG&c="]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3."]}," UTF-8 encoded  URL parameters"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\n        Encode the following using UTF-8:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        • POS ID",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        Unencoded POS ID:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POS00001"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        Encoded POS ID:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POS00001"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["4."]}," Build the URL payload"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\n        Format:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://payconiq.com/l/1/{PaymentProfileId}/{POSId}"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        Example:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://payconiq.com/l/1/5bb37284e35e2b29e363df22/POS00001"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5."]}," UTF-8 encode the URL payload"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\n        Before Encoding:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://payconiq.com/l/1/5bb37284e35e2b29e363df22/POS00001"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"\n        After Encoding:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https%3A%2F%2Fpayconiq.com%2Fl%2F1%2F5bb37284e35e2b29e363df22%2FPOS00001"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["6."]}," Combine service URL and encoded payload"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\n        Full URL:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://qrcodegenerator.api.bancontact.net/qrcode?f=PNG&s=XL&c=https%3A%2F%2Fpayconiq.com%2Fl%2F1%2F5bb37284e35e2b29e363df22%2FPOS00001"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now execute the URL in a web view to obtain your Static QR Code and print it on the medium of your choice."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-create-payment","__idx":11},"children":["2. Create Payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In order to initiate a payment, you will first have to create it through Bancontact via a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST"]}," request.  Each request will result in a unique payment identifier which will be valid for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["two minutes (120 seconds)"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the payment does not take place within these two minutes, a new payment must be created."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-request-body","__idx":12},"children":["📦 Request Body"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../apis/merchant-payment.openapi.yaml#/components/schemas/static_qr_payment_create_request"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/static_qr_payment_create_request"},"payment_reference":{"type":"string","description":"Partner payment reference, used to reference the Bancontact Company payment in the partner's system","maxLength":35,"examples":["19848995"]},"bulkId":{"type":"string","maxLength":35,"description":"Field used to reference a bulk batch, so the merchant can inform how the payments should be bulked. If it's not set here it will default to the one configured in the profile.","examples":["Bulk-1-200"]},"currency":{"type":"string","title":"Currency","description":"Currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)","enum":["EUR"],"default":"EUR"},"payment_description":{"type":"string","description":"Description of the payment that will be shown to the debtor, also used in the bank statement for reconciliation purposes. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best).\n","maxLength":140},"posId":{"type":"string","description":"Merchant's point of sale identifier","maxLength":36,"pattern":"^[A-Za-z0-9]+$","examples":["POS00001"]},"shopId":{"type":"string","description":"Id of the shop, where payment is created","maxLength":36,"examples":["3418e946-ef71-41ef-ad56-c41421c1e079"]},"VoucherScheme":{"type":"string","description":"Voucher scheme (voucher type), has the form [alpha-3-country-code]_[identifier]\ncurrently known values:\n  - BEL_MEAL_VOUCHER\n  - BEL_ECO_VOUCHER\n  - BEL_GIFT_VOUCHER\n  - BEL_COVID_VOUCHER\n  - BEL_SPORT_VOUCHER\n  - BEL_CONSUMPTION_VOUCHER\n\nThe api should allow for new schemes, providers and categories without having to upgrade all the services/apps\nusing this API. Because most services will use the java api artifact for this (which will 'close' any enums\ndefined in an openapi spec), the values above are not encoded explicitly as enums.\nThe 400 error response will report any invalid values for the scheme and providers.\n","examples":["BEL_MEAL_VOUCHER"],"minLength":1,"maxLength":36,"pattern":"^[A-Z]{3}_[A-Z_]+$"},"VoucherEligibleAmount":{"type":"object","description":"Defines an amount could be payed with proper voucher schemes","required":["voucherSchemes","amount"],"properties":{"voucherSchemes":{"type":"array","description":"List of voucher schemes could be used to pay the amount","minItems":1,"items":{"$ref":"#/components/schemas/VoucherScheme"}},"amount":{"type":"integer","description":"Amount in cents eligible for payment with voucher. EUR 10.13 will be 1013","format":"int64","minimum":1,"exclusiveMinimum":1,"maximum":999999999999,"examples":[1013]}}},"static_qr_payment_create_request":{"type":"object","title":"StaticQRPaymentCreateRequest","description":"Request to initiate/create a static qr payment as a Merchant","properties":{"reference":{"$ref":"#/components/schemas/payment_reference"},"bulkId":{"$ref":"#/components/schemas/bulkId"},"amount":{"type":"integer","description":"Amount in cents requested","format":"int64","minimum":1,"exclusiveMinimum":1,"maximum":999999999999},"currency":{"$ref":"#/components/schemas/currency"},"description":{"$ref":"#/components/schemas/payment_description"},"posId":{"$ref":"#/components/schemas/posId"},"shopId":{"$ref":"#/components/schemas/shopId"},"shopName":{"type":"string","description":"Name of the shop, where payment is created. This name will be shown to the user during payment, but will be truncated in the remittance info, if longer than 23 characters.","examples":["Bun café"],"maxLength":36},"identifyCallbackUrl":{"type":"string","description":"Callback url to which merchants will be notified about the payment identification. If it's not set here it will default to the one configured in the profile","minLength":1,"maxLength":2048,"examples":["https://api.merchant.bancontact.net/identify"]},"callbackUrl":{"type":"string","description":"Callback url to which the merchant will be notified about the payment payout/cancel. If it's not set here it will default to the one set in the profile","minLength":1,"maxLength":2048,"examples":["https://api.merchant.bancontact.net/payment"]},"voucherEligibility":{"deprecated":true,"type":"array","description":"List of Value Added Services (vouchers) eligible amounts within the payment","items":{"$ref":"#/components/schemas/VoucherEligibleAmount"}}},"required":["amount","posId"]}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-response","__idx":13},"children":["📥 Response"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../apis/merchant-payment.openapi.yaml#/components/schemas/payment_create_response"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/payment_create_response"},"currency":{"type":"string","title":"Currency","description":"Currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)","enum":["EUR"],"default":"EUR"},"payment_creditor_response":{"type":"object","title":"PaymentCreditorResponse","description":"Creditor account set to receive the payment","properties":{"profileId":{"type":"string","description":"The configuration ID of the Merchant","examples":["07e998f9-d932-4848-8b60-d5b5ae94b1b2"]},"merchantId":{"type":"string","description":"the Id of the merchant","examples":["dee718bb-3b6d-4312-9404-3d63d14529cc"]},"name":{"type":"string","description":"Merchant's company name that will be shown to the debtor","examples":["John"]},"iban":{"type":"string","description":"Creditor's Bank Account Iban to where the money will be sent to for this current payment","examples":["BE12 3456 7890 1234"]},"identifyCallbackUrl":{"type":"string","description":"callbackUrl to which the merchant will be notified about the payment identification","examples":["https://api.merchant.bancontact.net/identify"]},"callbackUrl":{"type":"string","description":"callbackUrl to which the merchant will be notified about the payment payout","examples":["https://api.merchant.bancontact.net/payment"]}}},"link":{"type":"object","title":"Link","properties":{"href":{"type":"string"}},"required":["href"]},"links":{"type":"object","title":"Links","description":"Provides information to navigate to our REST interfaces dynamically, by including hypermedia links to them. Note that for some links inclusion depends on the status of the payment (e.g. cancel link will be available on PENDING and refund on SUCCEEDED)","properties":{"self":{"$ref":"#/components/schemas/link","examples":["https://api.merchant.bancontact.net/5f91483d-78a7-4914-bc6f="]},"deeplink":{"$ref":"#/components/schemas/link","examples":["https://payconiq.com/pay/2/5f91483d-78a7-4914-bc6f="]},"qrcode":{"$ref":"#/components/schemas/link","examples":["https://qrcodegenerator.api.bancontact.net/qrcode?c=https%3A%2F%2Fpayconiq.com%2Fpay%2F2%2F5f91483d-78a7-4914-bc6f="]},"cancel":{"$ref":"#/components/schemas/link","examples":["https://api.merchant.bancontact.net/5f91483d-78a7-4914-bc6f="]},"refund":{"$ref":"#/components/schemas/link","examples":["https://merchant.api.bancontact.net/payments/5f91483d-78a7-4914-bc6f=/refunds"]},"checkout":{"$ref":"#/components/schemas/link","examples":["https://checkout.example.com?paymentId=12345&timestamp=1700000000000&token=abcdef1234567890"]}},"required":["self","deeplink","qrcode"]},"payment_create_response":{"type":"object","title":"PaymentCreateResponse","description":"Object returned if the payment gets successfully created","properties":{"paymentId":{"type":"string","description":"Payment ID","minLength":24,"maxLength":24,"examples":["5f91483d-78a7-4914-bc6f="]},"status":{"type":"string","enum":["PENDING"],"description":"the status of the payment created"},"createdAt":{"type":"string","format":"date-time","description":"the creation time of the payment"},"expiresAt":{"type":"string","format":"date-time","description":"the time from which the payment will be expired"},"description":{"type":"string","description":"Description of the payment that will be shown to the debtor, also used in the bank statement for reconciliation purposes. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best). Only first 35 characters will be used for the remittance info\n"},"reference":{"type":"string","description":"Merchant payment reference, used to reference the Bancontact Company payment in the merchant's system. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best).\n","examples":["19848995"]},"amount":{"type":"integer","format":"int64","minimum":1,"exclusiveMinimum":1,"maximum":999999999999,"description":"Amount in cents requested"},"currency":{"$ref":"#/components/schemas/currency"},"creditor":{"$ref":"#/components/schemas/payment_creditor_response"},"_links":{"$ref":"#/components/schemas/links"}},"required":["paymentId","status","createdAt","expiresAt","amount","currency","creditor","_links"]}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-error-codes-for-create","__idx":14},"children":["🔧 Error Codes for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]}]},{"$$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":"HTTP Status"},"children":["HTTP Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BODY_MISSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A json needs to be provided"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FIELD_IS_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field X is mandatory"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FIELD_IS_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field X is invalid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNAUTHORIZED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["user doesn’t have an access token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCESS_DENIED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The JWT could not be verified (different format) - The JWT doesn’t contain the required authority to access the resource requested"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MERCHANT_PROFILE_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The merchant profile does not exist"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNABLE_TO_PAY_CREDITOR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variable reason(Depends on automatic processing)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TECHNICAL_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Technical error in Payment service"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["503"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRY_AGAIN_LATER"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["one of the internal services is unavailable"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-sample-request--create-payment","__idx":15},"children":["🔍 Sample Request – ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create payment"]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/merchant-payment.openapi.yaml","operationId":"create_static_qr_payment","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-the-bancontact-callback","__idx":16},"children":["3. The Bancontact Callback"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can specify a callback URL where the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact  backend"]}," will send notifications about the status of a payment. This will allow you to take appropriate action and process the payment data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant backend"]}," must verify that the notification message originated from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bancontact backend"]}," was not altered or corrupted during the tranmission. To do so, please ensure signature validation."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full Callback documentation, please refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/general/callback052025"},"children":["Callback Guide"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-request-body-1","__idx":17},"children":["📦 Request Body"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../apis/merchant-payment.openapi.yaml#/components/schemas/merchant-callback"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/merchant-callback"},"merchant-payment-status":{"type":"string","title":"MerchantPaymentStatus","description":"| Status | Description |\n|--------|-------------|\n| PENDING | The merchant has created the payment and and is pending to proceed with identify step. |\n| IDENTIFIED | The user has scanned the payment's QR code with the Bancontact Pay. |\n| AUTHORIZED | The user has confirmed the payment and the bank authorized it. |\n| AUTHORIZATION_FAILED | The authorization with the bank failed. |\n| FAILED | Something went wrong during the payment process(e.g authorization failed). |\n| SUCCEEDED | The payment has succeeded. |\n| CANCELLED | When the payment has been canceled after the user has scanned it, or the merchant has cancelled the payment.|\n| EXPIRED | The payment has expired. |\n| PENDING_MERCHANT_ACKNOWLEDGEMENT | The payment is waiting for the merchant to acknowledge. |\n| VOIDED | The payment has been voided |\n","enum":["PENDING","IDENTIFIED","AUTHORIZED","AUTHORIZATION_FAILED","SUCCEEDED","FAILED","CANCELLED","EXPIRED","PENDING_MERCHANT_ACKNOWLEDGEMENT","VOIDED"]},"merchant-callback":{"type":"object","title":"MerchantCallback","properties":{"paymentId":{"type":"string","description":"Bancontact Company Payment ID","minLength":24,"maxLength":24,"examples":["5f91483d-78a7-4914-bc6f="]},"currency":{"type":"string","default":"EUR","description":"Only EUR is supported currently"},"amount":{"type":"integer","description":"Requested amount in cents","format":"int64"},"description":{"type":"string","description":"Description of the payment that will be shown to the debtor, also used in the bank statement for reconciliation purposes. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best).\n"},"reference":{"type":"string","description":"Merchant payment reference, used to reference the Bancontact Company payment in the merchant’s system. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best).\n","examples":["19848995"]},"createdAt":{"type":"string","format":"date-time","description":"When the payment was created"},"expireAt":{"type":"string","format":"date-time","description":"When the payment is going to expire. After that date the payment can't be confirmed anymore"},"succeededAt":{"type":"string","format":"date-time","description":"if the payment is SUCCEEDED, then this field represents the date-time on which the payment was SUCCEEDED"},"status":{"$ref":"#/components/schemas/merchant-payment-status"},"debtor":{"type":"object","description":"Customer that paid","required":["iban"],"properties":{"iban":{"type":"string","description":"Debtor's IBAN masked","examples":["*************12636"]},"name":{"type":"string","description":"Debtor's first name","examples":["John"]}}}},"required":["paymentId","totalAmount","currency","amount","createdAt","status","debtor"]}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-response-1","__idx":18},"children":["📥 Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(No defined response schema)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-sample-request--callback","__idx":19},"children":["🔍 Sample Request – ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callback"]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/merchant-payment.openapi.yaml","operationId":"callback","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"callback-failure","__idx":20},"children":["Callback Failure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the event you do not receive a callback or the callback validation fails, please refer to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Get Payment Details\""]},". This alternative will also allow you to confirm the status of a transaction in order to complete the payment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-get-payment-details","__idx":21},"children":["4. Get Payment Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By calling this endpoint you can obtain the details of an existing payment transaction by passing the unique payment ID."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," it is highly recommended to implement this call as a fallback option if callback fails."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-path-parameters","__idx":22},"children":["🧩 Path Parameters"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(string, required)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-response-2","__idx":23},"children":["📥 Response"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../apis/merchant-payment.openapi.yaml#/components/schemas/get_payment_response"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/get_payment_response"},"currency":{"type":"string","title":"Currency","description":"Currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)","enum":["EUR"],"default":"EUR"},"merchant-payment-status":{"type":"string","title":"MerchantPaymentStatus","description":"| Status | Description |\n|--------|-------------|\n| PENDING | The merchant has created the payment and and is pending to proceed with identify step. |\n| IDENTIFIED | The user has scanned the payment's QR code with the Bancontact Pay. |\n| AUTHORIZED | The user has confirmed the payment and the bank authorized it. |\n| AUTHORIZATION_FAILED | The authorization with the bank failed. |\n| FAILED | Something went wrong during the payment process(e.g authorization failed). |\n| SUCCEEDED | The payment has succeeded. |\n| CANCELLED | When the payment has been canceled after the user has scanned it, or the merchant has cancelled the payment.|\n| EXPIRED | The payment has expired. |\n| PENDING_MERCHANT_ACKNOWLEDGEMENT | The payment is waiting for the merchant to acknowledge. |\n| VOIDED | The payment has been voided |\n","enum":["PENDING","IDENTIFIED","AUTHORIZED","AUTHORIZATION_FAILED","SUCCEEDED","FAILED","CANCELLED","EXPIRED","PENDING_MERCHANT_ACKNOWLEDGEMENT","VOIDED"]},"payment_creditor_response":{"type":"object","title":"PaymentCreditorResponse","description":"Creditor account set to receive the payment","properties":{"profileId":{"type":"string","description":"The configuration ID of the Merchant","examples":["07e998f9-d932-4848-8b60-d5b5ae94b1b2"]},"merchantId":{"type":"string","description":"the Id of the merchant","examples":["dee718bb-3b6d-4312-9404-3d63d14529cc"]},"name":{"type":"string","description":"Merchant's company name that will be shown to the debtor","examples":["John"]},"iban":{"type":"string","description":"Creditor's Bank Account Iban to where the money will be sent to for this current payment","examples":["BE12 3456 7890 1234"]},"identifyCallbackUrl":{"type":"string","description":"callbackUrl to which the merchant will be notified about the payment identification","examples":["https://api.merchant.bancontact.net/identify"]},"callbackUrl":{"type":"string","description":"callbackUrl to which the merchant will be notified about the payment payout","examples":["https://api.merchant.bancontact.net/payment"]}}},"link":{"type":"object","title":"Link","properties":{"href":{"type":"string"}},"required":["href"]},"links":{"type":"object","title":"Links","description":"Provides information to navigate to our REST interfaces dynamically, by including hypermedia links to them. Note that for some links inclusion depends on the status of the payment (e.g. cancel link will be available on PENDING and refund on SUCCEEDED)","properties":{"self":{"$ref":"#/components/schemas/link","examples":["https://api.merchant.bancontact.net/5f91483d-78a7-4914-bc6f="]},"deeplink":{"$ref":"#/components/schemas/link","examples":["https://payconiq.com/pay/2/5f91483d-78a7-4914-bc6f="]},"qrcode":{"$ref":"#/components/schemas/link","examples":["https://qrcodegenerator.api.bancontact.net/qrcode?c=https%3A%2F%2Fpayconiq.com%2Fpay%2F2%2F5f91483d-78a7-4914-bc6f="]},"cancel":{"$ref":"#/components/schemas/link","examples":["https://api.merchant.bancontact.net/5f91483d-78a7-4914-bc6f="]},"refund":{"$ref":"#/components/schemas/link","examples":["https://merchant.api.bancontact.net/payments/5f91483d-78a7-4914-bc6f=/refunds"]},"checkout":{"$ref":"#/components/schemas/link","examples":["https://checkout.example.com?paymentId=12345&timestamp=1700000000000&token=abcdef1234567890"]}},"required":["self","deeplink","qrcode"]},"get_payment_response":{"type":"object","title":"GetPaymentResponse","description":"Response containing information on the requested payment.","properties":{"paymentId":{"type":"string","description":"id of the payment","minLength":24,"maxLength":24,"examples":["5f91483d-78a7-4914-bc6f="]},"createdAt":{"type":"string","format":"date-time","description":"the creation time of the payment"},"expireAt":{"type":"string","format":"date-time","description":"the time from which the payment will be expired"},"succeededAt":{"type":"string","format":"date-time","description":"if the payment is SUCCEEDED, then this field represents the date-time on which the payment was SUCCEEDED"},"currency":{"$ref":"#/components/schemas/currency"},"status":{"$ref":"#/components/schemas/merchant-payment-status"},"creditor":{"$ref":"#/components/schemas/payment_creditor_response"},"debtor":{"type":"object","properties":{"name":{"type":"string","description":"First name of Debtor","examples":["John"]},"iban":{"type":"string","description":"IBAN of Debtor masked","examples":["*************12636"]}}},"amount":{"type":"integer","format":"int64","description":"Amount in cents originally requested. If no amount was requested by creditor, this will be 0"},"description":{"type":"string","description":"merchant's description of the payment","examples":["5 coke."]},"message":{"type":"string","description":"debtor's message of the payment","examples":["Money send."]},"reference":{"type":"string","description":"Merchant payment reference, used to reference the Bancontact Company payment. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best). in the merchant's system\n","examples":["19848995"]},"bulkId":{"type":"string","description":"Field used to reference a bulk batch, so the merchant can choose how to bulk the payments. Mandatory if  merchant profile does have bulking enabled, otherwise will miss from the response. If it's not set in the create call it will default to the value configured in the profile if it exists, otherwise its value will be defaulted by the application.","examples":["Bulk-1-200"]},"_links":{"$ref":"#/components/schemas/links"}},"required":["paymentId","createdAt","expireAt","currency","status","creditor","amount","totalAmount"]}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-error-codes-for-merchant-get-payment","__idx":24},"children":["🔧 Error Codes for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant-get-payment"]}]},{"$$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":"HTTP Status"},"children":["HTTP Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNAUTHORIZED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["caller doesn’t have an api-key access token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCESS_DENIED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["api-key access token is invalid, creditor is not a participant of the requested payment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["no payment could be found"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TECHNICAL_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Technical error in Payment service"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-sample-request--merchant-get-payment","__idx":25},"children":["🔍 Sample Request – ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant-get-payment"]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/merchant-payment.openapi.yaml","operationId":"merchant-get-payment","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"5-get-payment-list","__idx":26},"children":["5. Get Payment List"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also retrieve a list of payments by specifying how many records to return, as well as a filter on the results for the total number of records returned per page."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-request-body-2","__idx":27},"children":["📦 Request Body"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../apis/merchant-payment.openapi.yaml#/components/schemas/payment-search-query"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/payment-search-query"},"merchant-payment-status":{"type":"string","title":"MerchantPaymentStatus","description":"| Status | Description |\n|--------|-------------|\n| PENDING | The merchant has created the payment and and is pending to proceed with identify step. |\n| IDENTIFIED | The user has scanned the payment's QR code with the Bancontact Pay. |\n| AUTHORIZED | The user has confirmed the payment and the bank authorized it. |\n| AUTHORIZATION_FAILED | The authorization with the bank failed. |\n| FAILED | Something went wrong during the payment process(e.g authorization failed). |\n| SUCCEEDED | The payment has succeeded. |\n| CANCELLED | When the payment has been canceled after the user has scanned it, or the merchant has cancelled the payment.|\n| EXPIRED | The payment has expired. |\n| PENDING_MERCHANT_ACKNOWLEDGEMENT | The payment is waiting for the merchant to acknowledge. |\n| VOIDED | The payment has been voided |\n","enum":["PENDING","IDENTIFIED","AUTHORIZED","AUTHORIZATION_FAILED","SUCCEEDED","FAILED","CANCELLED","EXPIRED","PENDING_MERCHANT_ACKNOWLEDGEMENT","VOIDED"]},"payment-search-query":{"type":"object","title":"PaymentSearchQuery","properties":{"from":{"type":"string","format":"date-time","description":"default is today - 1day (yesterday)"},"to":{"type":"string","format":"date-time"},"paymentStatuses":{"type":"array","items":{"$ref":"#/components/schemas/merchant-payment-status"}},"reference":{"type":"string","description":"Merchant payment reference, used to reference Bancontact Company payment in merchant system. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best).\n","examples":["19848995"]}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-response-3","__idx":28},"children":["📥 Response"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../apis/merchant-payment.openapi.yaml#/components/schemas/PaymentSearchResponse"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/PaymentSearchResponse"},"AbstractListResponsePayment":{"type":"object","properties":{"size":{"type":"integer","minimum":0,"description":"Size of the elements returned in current page"},"totalPages":{"type":"integer","description":"Total number of pages in the backend for the list requested"},"totalElements":{"type":"integer","description":"Total number of elements in the list requested\n"},"number":{"type":"integer","description":"Current page number"}},"required":["size","totalPages","totalElements","number"]},"currency":{"type":"string","title":"Currency","description":"Currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)","enum":["EUR"],"default":"EUR"},"merchant-payment-status":{"type":"string","title":"MerchantPaymentStatus","description":"| Status | Description |\n|--------|-------------|\n| PENDING | The merchant has created the payment and and is pending to proceed with identify step. |\n| IDENTIFIED | The user has scanned the payment's QR code with the Bancontact Pay. |\n| AUTHORIZED | The user has confirmed the payment and the bank authorized it. |\n| AUTHORIZATION_FAILED | The authorization with the bank failed. |\n| FAILED | Something went wrong during the payment process(e.g authorization failed). |\n| SUCCEEDED | The payment has succeeded. |\n| CANCELLED | When the payment has been canceled after the user has scanned it, or the merchant has cancelled the payment.|\n| EXPIRED | The payment has expired. |\n| PENDING_MERCHANT_ACKNOWLEDGEMENT | The payment is waiting for the merchant to acknowledge. |\n| VOIDED | The payment has been voided |\n","enum":["PENDING","IDENTIFIED","AUTHORIZED","AUTHORIZATION_FAILED","SUCCEEDED","FAILED","CANCELLED","EXPIRED","PENDING_MERCHANT_ACKNOWLEDGEMENT","VOIDED"]},"payment_creditor_response":{"type":"object","title":"PaymentCreditorResponse","description":"Creditor account set to receive the payment","properties":{"profileId":{"type":"string","description":"The configuration ID of the Merchant","examples":["07e998f9-d932-4848-8b60-d5b5ae94b1b2"]},"merchantId":{"type":"string","description":"the Id of the merchant","examples":["dee718bb-3b6d-4312-9404-3d63d14529cc"]},"name":{"type":"string","description":"Merchant's company name that will be shown to the debtor","examples":["John"]},"iban":{"type":"string","description":"Creditor's Bank Account Iban to where the money will be sent to for this current payment","examples":["BE12 3456 7890 1234"]},"identifyCallbackUrl":{"type":"string","description":"callbackUrl to which the merchant will be notified about the payment identification","examples":["https://api.merchant.bancontact.net/identify"]},"callbackUrl":{"type":"string","description":"callbackUrl to which the merchant will be notified about the payment payout","examples":["https://api.merchant.bancontact.net/payment"]}}},"link":{"type":"object","title":"Link","properties":{"href":{"type":"string"}},"required":["href"]},"links":{"type":"object","title":"Links","description":"Provides information to navigate to our REST interfaces dynamically, by including hypermedia links to them. Note that for some links inclusion depends on the status of the payment (e.g. cancel link will be available on PENDING and refund on SUCCEEDED)","properties":{"self":{"$ref":"#/components/schemas/link","examples":["https://api.merchant.bancontact.net/5f91483d-78a7-4914-bc6f="]},"deeplink":{"$ref":"#/components/schemas/link","examples":["https://payconiq.com/pay/2/5f91483d-78a7-4914-bc6f="]},"qrcode":{"$ref":"#/components/schemas/link","examples":["https://qrcodegenerator.api.bancontact.net/qrcode?c=https%3A%2F%2Fpayconiq.com%2Fpay%2F2%2F5f91483d-78a7-4914-bc6f="]},"cancel":{"$ref":"#/components/schemas/link","examples":["https://api.merchant.bancontact.net/5f91483d-78a7-4914-bc6f="]},"refund":{"$ref":"#/components/schemas/link","examples":["https://merchant.api.bancontact.net/payments/5f91483d-78a7-4914-bc6f=/refunds"]},"checkout":{"$ref":"#/components/schemas/link","examples":["https://checkout.example.com?paymentId=12345&timestamp=1700000000000&token=abcdef1234567890"]}},"required":["self","deeplink","qrcode"]},"get_payment_response":{"type":"object","title":"GetPaymentResponse","description":"Response containing information on the requested payment.","properties":{"paymentId":{"type":"string","description":"id of the payment","minLength":24,"maxLength":24,"examples":["5f91483d-78a7-4914-bc6f="]},"createdAt":{"type":"string","format":"date-time","description":"the creation time of the payment"},"expireAt":{"type":"string","format":"date-time","description":"the time from which the payment will be expired"},"succeededAt":{"type":"string","format":"date-time","description":"if the payment is SUCCEEDED, then this field represents the date-time on which the payment was SUCCEEDED"},"currency":{"$ref":"#/components/schemas/currency"},"status":{"$ref":"#/components/schemas/merchant-payment-status"},"creditor":{"$ref":"#/components/schemas/payment_creditor_response"},"debtor":{"type":"object","properties":{"name":{"type":"string","description":"First name of Debtor","examples":["John"]},"iban":{"type":"string","description":"IBAN of Debtor masked","examples":["*************12636"]}}},"amount":{"type":"integer","format":"int64","description":"Amount in cents originally requested. If no amount was requested by creditor, this will be 0"},"description":{"type":"string","description":"merchant's description of the payment","examples":["5 coke."]},"message":{"type":"string","description":"debtor's message of the payment","examples":["Money send."]},"reference":{"type":"string","description":"Merchant payment reference, used to reference the Bancontact Company payment. The characters used must comply with the [SEPA Requirements for an Extended Character Set (UNICODE Subset) - Best Practices | European Payments Council](https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best). in the merchant's system\n","examples":["19848995"]},"bulkId":{"type":"string","description":"Field used to reference a bulk batch, so the merchant can choose how to bulk the payments. Mandatory if  merchant profile does have bulking enabled, otherwise will miss from the response. If it's not set in the create call it will default to the value configured in the profile if it exists, otherwise its value will be defaulted by the application.","examples":["Bulk-1-200"]},"_links":{"$ref":"#/components/schemas/links"}},"required":["paymentId","createdAt","expireAt","currency","status","creditor","amount","totalAmount"]},"PaymentSearchResponse":{"allOf":[{"$ref":"#/components/schemas/AbstractListResponsePayment"},{"type":"object","properties":{"details":{"type":"array","items":{"$ref":"#/components/schemas/get_payment_response"}}}}]}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-error-codes-for-search","__idx":29},"children":["🔧 Error Codes for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$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":"HTTP Status"},"children":["HTTP Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNAUTHORIZED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["caller doesn’t have an api-key access token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCESS_DENIED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["api-key access token is invalid, creditor it's not a participant of the requested payment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TECHNICAL_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Technical error in Payment service"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-sample-request--search","__idx":30},"children":["🔍 Sample Request – ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/merchant-payment.openapi.yaml","operationId":"search","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"canceling-a-payment","__idx":31},"children":["Canceling a Payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete-payment"]}," can be used to cancel a created payment that is still in status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]},"."," ","The endpoint can also be used to cancel a payment in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IDENTIFIED"]}," status, as long as the consumer has"," ","not initiated payment confirmation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-path-parameters-1","__idx":32},"children":["🧩 Path Parameters"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(string, required)"]}," — Payment Id"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-error-codes-for-delete-payment","__idx":33},"children":["🔧 Error Codes for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete-payment"]}]},{"$$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":"HTTP Status"},"children":["HTTP Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNAUTHORIZED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["user doesn't have an access token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCESS_DENIED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["access token is invalid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CALLER_NOT_ALLOWED_TO_CANCEL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["if caller is not a participant of the payment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["payment is not found in the system"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_NOT_PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["payment is not in pending or identify state"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TECHNICAL_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Technical error in Payment service"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-sample-request--delete-payment","__idx":34},"children":["🔍 Sample Request – ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete-payment"]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/merchant-payment.openapi.yaml","operationId":"cancel_payment","parameters":{},"environments":{}},"children":[]}]},"headings":[{"value":"Static QR Code","id":"static-qr-code","depth":1},{"value":"Introduction","id":"introduction","depth":2},{"value":"Process Flow","id":"process-flow","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":3},{"value":"Involved Parties","id":"involved-parties","depth":3},{"value":"Step-by-Step Payment Flow","id":"step-by-step-payment-flow","depth":3},{"value":"Payment Flow Diagram","id":"payment-flow-diagram","depth":2},{"value":"Implementation Guide","id":"implementation-guide","depth":2},{"value":"1. Create a Static QR Code","id":"1-create-a-static-qr-code","depth":3},{"value":"Static QR Code Parameters","id":"static-qr-code-parameters","depth":4},{"value":"Static QR Code creation process","id":"static-qr-code-creation-process","depth":4},{"value":"2. Create Payment","id":"2-create-payment","depth":3},{"value":"📦 Request Body","id":"-request-body","depth":4},{"value":"📥 Response","id":"-response","depth":4},{"value":"🔧 Error Codes for create","id":"-error-codes-for-create","depth":4},{"value":"🔍 Sample Request – create payment","id":"-sample-request--create-payment","depth":4},{"value":"3. The Bancontact Callback","id":"3-the-bancontact-callback","depth":3},{"value":"📦 Request Body","id":"-request-body-1","depth":4},{"value":"📥 Response","id":"-response-1","depth":4},{"value":"🔍 Sample Request – callback","id":"-sample-request--callback","depth":4},{"value":"Callback Failure","id":"callback-failure","depth":4},{"value":"4. Get Payment Details","id":"4-get-payment-details","depth":3},{"value":"🧩 Path Parameters","id":"-path-parameters","depth":4},{"value":"📥 Response","id":"-response-2","depth":4},{"value":"🔧 Error Codes for merchant-get-payment","id":"-error-codes-for-merchant-get-payment","depth":4},{"value":"🔍 Sample Request – merchant-get-payment","id":"-sample-request--merchant-get-payment","depth":4},{"value":"5. Get Payment List","id":"5-get-payment-list","depth":3},{"value":"📦 Request Body","id":"-request-body-2","depth":4},{"value":"📥 Response","id":"-response-3","depth":4},{"value":"🔧 Error Codes for search","id":"-error-codes-for-search","depth":4},{"value":"🔍 Sample Request – search","id":"-sample-request--search","depth":4},{"value":"Canceling a Payment","id":"canceling-a-payment","depth":2},{"value":"🧩 Path Parameters","id":"-path-parameters-1","depth":3},{"value":"🔧 Error Codes for delete-payment","id":"-error-codes-for-delete-payment","depth":3},{"value":"🔍 Sample Request – delete-payment","id":"-sample-request--delete-payment","depth":3}],"frontmatter":{"seo":{"title":"Static QR Code"}},"lastModified":"2026-03-17T08:18:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/instore/staticqr052025v4","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}