{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-vas/vas.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Bill Payment 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":"bill-payment-for-digital-channels"},"children":["Bill Payment for digital channels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/vas/public/advanced-topics/dual-and-single-messaging"},"children":["Dual messaging"]}," plays an important role in transaction processing. This message structure sends a follow-up advice message—either a confirmation or a reversal—to ensure that all entities (originating system, Electrum and service provider) reflect the same transaction state."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["However, some digital channels cannot natively handle dual messaging. To address this, Electrum provides a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/vas/public/advanced-topics/dual-and-single-messaging"},"children":["single message solution"]},", where we manage confirmation messages and reversals on behalf of the originating system. This means you don’t have to implement dual messaging. See the sections below for single messaging implementation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The different transaction legs for single message solution are as follows."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["account lookup phase"]}," verifies the consumer's account reference and returns outstanding balances."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system tenders for the account payment during the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["account payment phase"]},", and Electrum's Switch sends a successful payment message downstream to the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum will finalise the transaction on behalf of the originating system during the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["confirmation phase"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["lookup status phase"]}," where the outcome of a prior payment is retrieved by the originating system from Electrum."]}]},{"$$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 operations and message payloads supported for the various legs of a bill payment transaction. For more detail, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger"},"children":["Account Payments Service Interface"]}," specification. Example message payloads are available ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/vas/public/bill-payments/integrate-your-channel/message-payload-samples"},"children":["here"]},"."]},{"$$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":"Message Type"},"children":["Message Type"]},{"$$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":["Lookup phase"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lookupBills"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET/bills/{referenceNumber}"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/billlookupresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillLookupResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bill payment phase: standard bill"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/createaccountpayment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createAccountPayment"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/{paymentId}"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentRequest"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bill payment phase: traffic fine"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/createtrafficfinepayment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createTrafficFinePayment"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/traffic{paymentId}"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/trafficfinepaymentrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TrafficFinePaymentRequest"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/trafficfinepaymentresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TrafficFinePaymentResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lookup Status Phase"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/paymentstatus"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentStatus"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /payments/status/{paymentMsgId}"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRequest"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]}]}]}]}]}]},{"$$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)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"message-flows"},"children":["Message Flows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sections below describe the message flows for successful bill payments and error scenarios during bill payment transactions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"successful-bill-or-traffic-fine-payment"},"children":["Successful Bill or Traffic Fine Payment"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/bills/{referenceNumber}"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lookupBills"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum translates the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lookupBills"]}]}," message and sends a lookup request to the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum forwards the service provider's lookup response downstream as a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/billlookupresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillLookupResponse"]}]}," message payload to the originating system containing the details (amount due, minimum amount, maximum amount and whether it is over payable) of any bills associated with that reference number."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The consumer receives a list of bills associated with the corresponding reference number via the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/billlookupresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillLookupResponse"]}]}," message."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The consumer selects the bill that will be paid and tenders for the payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentRequest"]}]}," message to Electrum. This request will include only one of the reference numbers which was returned to the originating system in the initial ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/billlookupresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillLookupResponse"]}]}," message."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentRequest"]}]}," message to the bill pay service provider to authorise the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The service provider responds to Electrum with a message indicating that the transaction is successfully authorised."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentResponse"]}]}," downstream to confirm that a successful payment has been made."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/confirmpayment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmPayment"]}]}," message to the provider via a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/vas/public/advanced-topics/store-and-forward-queues"},"children":["store-and-forward queue"]},", and repeats the message until a response is received from upstream."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bill-payment-digital-channel-single-messaging-successful-1.0402aade8100cfe001039eb64e3883c9788140ef303b00aabd810710d9ac8cbd.45baa1d1.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-at-service-provider"},"children":["Error at Service Provider"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system captures the payment request information and sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/{paymentId}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/traffic/{paymentId}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentrequest"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentRequest"]}]}," message to the bill pay service provider to authorise the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error occurs at the service provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The service provider respond to Electrum with an error response message."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum responds to the originating system with an HTTP status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["503"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["504"]},", and an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bill-payment-digital-channel-single-messaging-error-at-sp-1.491bb7f71d953bd7da7228437f34052cb4c97dd8c23c5644c93b1a210564f93f.45baa1d1.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"timeout-or-other-errors-at-electrum"},"children":["Timeout or other errors at Electrum"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system captures the payment request information and sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/{paymentId}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/traffic/{paymentId}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error or timeout occurs at Electrum."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum responds to the originating system with an HTTP status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["503"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["504"]},", and an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If necessary, Electrum sends a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/basicreversal"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BasicReversal"]}]}," message to the service provider and repeats the message until a response is received."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bill-payment-digital-channel-single-messaging-time-out-or-o-errors-1.491bb7f71d953bd7da7228437f34052cb4c97dd8c23c5644c93b1a210564f93f.45baa1d1.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"timeout-at-originating-system"},"children":["Timeout at Originating System"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system captures the payment request information and sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/{paymentId}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/traffic/{paymentId}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error occurs at the originating system, or a timeout occurs when the originating system does not receive a response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/confirmpayment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmPayment"]}]},"  message to the provider via a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrum.io/v1/docs/store-and-forward-queues"},"children":["store-and-forward queue"]},", and repeats the message until a response is received from upstream"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a GET call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/{paymentId}/paymentStatus/{adviceId}"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/paymentstatus"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentStatus"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum responds with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/paymentresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentResponse"]}]}," message via a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/vas/public/advanced-topics/store-and-forward-queues"},"children":["store-and-forward queue"]},", and repeats the message until a response is received from downstream."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bill-payment-dc-messaging-time-out-at-os.711e2aace2f3627092b71f6969cb1318773e7033f7a2104a208f92ee1e959275.45baa1d1.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the event that a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PaymentResponse"]}," is not timeously received from Electrum, the downstream entity may resend the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentStatus"]}," a configurable amount of times."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"timeout-at-originating-system-and-service-provider"},"children":["Timeout at Originating System and Service Provider"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system captures the payment request information and sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/{paymentId}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/traffic/{paymentId}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error occurs at the service provider, or a timeout occurs when the service provider does not receive a request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum responds to the originating system with an HTTP status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["503"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["504"]},", and an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A timeout occurs at the originating system, and the originating system does not receive an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," response from Electrum."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends a reversal message to the service provider and repeats the message until a response is received."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payments/{paymentId}/paymentStatus/{adviceId}"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/paymentstatus"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentStatus"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum responds to the originating system with an HTTP status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["503"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["504"]},", and an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/lookupbills"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bill-payment-dc-sm-error-at-os-and-sp.e68c3f0acaba1a8ad34c7e3669fbd6a37d6d8cb0a787c87e0199851868c5caac.45baa1d1.png","alt":"alt text"},"children":[]}]}]},"headings":[{"value":"Bill Payment for digital channels","id":"bill-payment-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 Bill or Traffic Fine Payment","id":"successful-bill-or-traffic-fine-payment","depth":2},{"value":"Error at Service Provider","id":"error-at-service-provider","depth":2},{"value":"Timeout or other errors at Electrum","id":"timeout-or-other-errors-at-electrum","depth":2},{"value":"Timeout at Originating System","id":"timeout-at-originating-system","depth":2},{"value":"Timeout at Originating System and Service Provider","id":"timeout-at-originating-system-and-service-provider","depth":2}],"frontmatter":{"seo":{"title":"Bill Payment for digital channels"}},"lastModified":"2026-01-28T10:41:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/vas/public/bill-payments/integrate-your-channel/bill-payment/bill-payment-for-digital-channel","userData":{"isAuthenticated":false,"teams":["anonymous"]}}