{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-vas/vas.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Voucher provision for digital channels","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"voucher-provision-for-digital-channels"},"children":["Voucher provision for digital channels"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operations-and-messages"},"children":["Operations and Messages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table below lists the single messaging transactions that make up digital voucher provisions and the API calls you will need to implement for your digital channel."]},{"$$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":"Transaction Leg"},"children":["Transaction Leg"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Calls"},"children":["API Calls"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Provision voucher"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/provisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionVoucher"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /vouchers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProvisionRequest"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProvisionResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry voucher provision"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/retryprovisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryProvisionVoucher"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /vouchers/{provisionId}/retry"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProvisionRequest"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProvisionResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reverse voucher"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/reversevoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reverseVoucher"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /vouchers/reversals"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/basicreversal"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BasicReversal"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/basicreversal"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BasicReversal"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lookup products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/lookupproducts"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lookupProducts"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /products"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/lookupproducts"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lookupProducts"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/productslookupresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProductsLookupResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stellr does not support advice messages (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/vas/public/advanced-topics/reversals-and-refunds"},"children":["reversals"]}," or confirmations), therefore if implemented Electrum will consume any advice messages sent to the Electrum Switch."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Netcare and Stellr do not support retries, therefore Electrum will respond with a hard decline when a retry is sent to the Electrum Switch."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"message-flows"},"children":["Message Flows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The voucher provision phase of a digital voucher purchase initiates the transaction and returns a digital voucher from the service provider. In the case of ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/vas/public/advanced-topics/dual-and-single-messaging"},"children":["single messaging"]}," Electrum manages confirmation messages and reversals on behalf of the originating system."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sections below describe successful voucher provision transactions and error scenarios."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"successful-voucher-provision"},"children":["Successful Voucher Provision"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vouchers"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/provisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionVoucher"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API responds with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProvisionResponse"]}]}," message payload containing the details of the voucher."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The transaction is complete."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/successful-digital-vouchers-provision-single.806ba4039db5e493720237a51711d4fa3864942f9ce8f41d13f7d6c8622a950e.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-or-timeout-at-service-provider"},"children":["Error or Timeout at Service Provider"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vouchers"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/provisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionVoucher"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A hard decline or other error is encountered at the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum responds to the originating system with an HTTP status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}," and an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the case of a hard decline, no further messaging is required from the originating system."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/copy-of-successful-digital-vouchers-provision-single---pv_error-at-sp.269f7734bb8a81eec24f218d6a1d980b7eb2e69d31d5df6acb72adef758e258e.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"timeout-or-other-error-at-electrum"},"children":["Timeout or Other Error at Electrum"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vouchers"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/provisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionVoucher"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum forwards the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProvisionRequest"]}]}," message to the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A timeout (no response received) or other error is encountered at Electrum before receiving a successful ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProvisionResponse"]}]}," from the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload to the originating system and immediately sends a reversal message to the service provider."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/copy-of-successful-digital-vouchers-provision-single---pv_error-at-electrum.24834277a3a17c28573059d5d1dc470539b63b6132e31a1c3cbe4ed108280df9.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"timeout-downstream-successful-retry"},"children":["Timeout Downstream: Successful Retry"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vouchers"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/provisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionVoucher"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum forwards the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionRequest"]}]}," message to the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The service provider returns a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionResponse"]}]}," message payload containing the details of the voucher to Electrum. Electrum forwards this response to the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A timeout occurs at the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system initiates a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/retryprovisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryProvisionVoucher"]}]}," to resubmit the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum searches for the original transaction outcome and responds with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionResponse"]}]}," message payload containing the details of the voucher to the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system successfully receives a response with the voucher details."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/copy-of-successful-digital-vouchers-provision-single---os-timeout-successful-retry.594d9181bfc783ae120fe68e7cccc533892d23038cb4e8ea9f181f09d7785b52.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"timeout-downstream-unsuccessful-retry"},"children":["Timeout Downstream: Unsuccessful Retry"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vouchers"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/provisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionVoucher"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum forwards the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionRequest"]}]}," message to the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The service provider returns a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionResponse"]}]}," message payload containing the details of the voucher to Electrum. Electrum forwards this response to the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A timeout occurs at the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system initiates a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/retryprovisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryProvisionVoucher"]}]}," to resubmit the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum searches for the original transaction outcome and responds with an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload to the originating system."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/copy-of-successful-digital-vouchers-provision-single----os-timeout-unsuccessful-retry.810d3c1bdff9ef8f3c1d72636d241d1ec4cc80d3f74b1bd5be64133af53c63fe.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the originating system continues to time out before receiving a response from Electrum, it will send a  ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/basicreversal"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BasicReversal"]}]}," message via a store-and-forward queue to Electrum, who will forward the message to the service provider as below:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-downstream-timeout-persists"},"children":["Error Downstream: Timeout Persists"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/vouchers"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/provisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionVoucher"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum forwards the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionRequest"]}]}," message to the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The service provider returns a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/provisionresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisionResponse"]}]}," message payload containing the details of the voucher to Electrum. Electrum forwards this response to the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A timeout occurs at the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system initiates a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/other/retryprovisionvoucher"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryProvisionVoucher"]}]}," to resubmit the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system continues to time out before receiving a response from Electrum."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/basicreversal"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BasicReversal"]}]}," message via a store-and-forward queue to Electrum."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum forwards the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/suv/swagger/schema/basicreversal"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BasicReversal"]}]}," message to the service provider and the service provider reverses the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum forwards the response to the originating system."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/copy-of-successful-digital-vouchers-provision-single---timeout-persists.81d2ddb56379b01787eab80da951c418afe34c7df3ca22e3fe1ef07494e822f5.f0281c88.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You should not attempt transaction lookups until after the initial processing period concludes (after Electrum has received and processed the transaction outcome)."]}]}]},"headings":[{"value":"Voucher provision for digital channels","id":"voucher-provision-for-digital-channels","depth":1},{"value":"Operations and Messages","id":"operations-and-messages","depth":2},{"value":"Message Flows","id":"message-flows","depth":2},{"value":"Successful Voucher Provision","id":"successful-voucher-provision","depth":2},{"value":"Error or Timeout at Service Provider","id":"error-or-timeout-at-service-provider","depth":2},{"value":"Timeout or Other Error at Electrum","id":"timeout-or-other-error-at-electrum","depth":2},{"value":"Timeout Downstream: Successful Retry","id":"timeout-downstream-successful-retry","depth":2},{"value":"Timeout Downstream: Unsuccessful Retry","id":"timeout-downstream-unsuccessful-retry","depth":2},{"value":"Error Downstream: Timeout Persists","id":"error-downstream-timeout-persists","depth":2}],"frontmatter":{"seo":{"title":"Voucher provision for digital channels"}},"lastModified":"2026-01-28T10:41:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/vas/public/digital-vouchers/integrate-your-channel/voucher-provision-for-digital-channels","userData":{"isAuthenticated":false,"teams":["anonymous"]}}