{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/deluxe-payment-network/build-with-deluxe/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","numbered-list","numbered-item"]},"redocly_category":"Developer Resources","page_type":"Guide","api":"DPN","content_domain":"Integration Planning & Go-Live","type":"markdown"},"seo":{"title":"Plan Your Payment Network Integration","siteUrl":"https://developer.deluxe.com","description":"Explore the payment lifecycle, APIs, participant responsibilities, reconciliation, and Print-and-Scan and Print-and-Mail fulfillment.","llmstxt":{"title":"Deluxe Developers","description":"Build secure payment experiences and onboard merchants with Merchant Services, or submit, track, and reconcile payments through a single Payment Network integration.","details":{"content":"Merchant Services helps businesses and platforms build secure payment experiences,\nonboard merchants, and integrate the payment capabilities their customers need.\nCapabilities include cards, ACH, wallets, recurring payments, tokenization, surcharge,\nreporting and reconciliation, and invoicing. Developer resources include APIs, SDKs,\nauthentication, webhooks, testing, and interactive demos.\n\nDeluxe Payment Network (DPN) supports payment workflows from submission to\nreconciliation through a single integration. Integrators can build payment files,\nsubmit and monitor payments, track payment status, and use Print + Scan or Print + Mail\nfulfillment workflows. Use DPN APIs for payment submission and tracking; use the\nPayables DDN API for lockbox directory lookup and destination validation.\n\nStart with the relevant product's getting-started and implementation guidance, then\nconsult its API reference and developer resources.\n"},"sections":[{"title":"Merchant Services","description":"Payment acceptance, platform services, merchant onboarding, APIs, and developer resources.","includeFiles":["products/merchant-services/**"]},{"title":"Deluxe Payment Network (DPN)","description":"Payment file submission, tracking, reconciliation, integration guides, and APIs.","includeFiles":["products/deluxe-payment-network/**"]}]},"keywords":["payment lifecycle","implementation","Print + Scan","Print + Mail","DPN"]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"plan-your-integration","__idx":0},"children":["Plan Your Integration"]},{"$$mdtype":"Tag","name":"span","attributes":{"style":{"fontSize":"150%"}},"children":["\nUnderstand the payment lifecycle before you build.\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understand how payment data moves through Payment Network from submission through reconciliation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explore the APIs, workflows, participant responsibilities, and resources required to design and implement your integration."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-lifecycle","__idx":1},"children":["Payment Lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A typical payment follows this workflow:"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/dpn-payment-lifecycle.8526d42120b9168a4fbc9f7cdda523630132c03519ac5475cf8fe3d4fb9c1ccd.aeb2f956.png","alt":"DPN payment disbursement workflow showing payment instructions submitted through DPN APIs, validated and routed to Print + Scan or Print + Mail fulfillment channels, processed through a payment processor or courier network, and returned to the payment disburser through DPN Status & Tracking. Detailed workflow follows.","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"NumberedList","attributes":{"type":"number","size":"medium"},"children":[{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":1,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit Payment Instructions"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The payment disburser submits payment instructions through DPN APIs and authenticates the request."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":2,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate and Route Payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"DPN Payment Intake and Intelligent Route validates and enriches the payment data, applies business rules, and routes the payment to the appropriate fulfillment channel."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":3,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fulfill Payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The payment follows the appropriate fulfillment channel. Print + Scan reconciles the payment to lockbox, creates the package, and supports daily delivery. Print + Mail prints and packages the payment for courier delivery and tracking."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":4,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Process Fulfillment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Print + Scan payments are sent to the payment processor for acknowledgement and completion status. Print + Mail payments are sent through the courier network for tracking events and delivery status."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":5,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Track Payment Status"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"DPN Status & Tracking consolidates acknowledgements, tracking events, completion status, and payment information into a unified payment view."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":6,"isLast":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retrieve Status and Tracking"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The payment disburser uses the same DPN APIs to retrieve real-time payment status, tracking, and completion information."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"responsibility-overview","__idx":2},"children":["Responsibility Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Print + Scan workflow involves multiple participants. Each participant is responsible for a specific part of the payment lifecycle."]},{"$$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":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Responsible Party"},"children":["Responsible Party"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit payment instructions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disburser"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve lockbox information (optional)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disburser"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate payment data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Match the payment to a lockbox destination"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send payment data for fulfillment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Produce checks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deluxe Fulfillment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Scan check images"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deluxe Fulfillment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return scanned check images to DPN"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deluxe Fulfillment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Match scanned images to the original payment data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deliver the payment package to the lockbox provider"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Process the transaction"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lockbox Provider"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Deposit checks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lockbox Provider"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return acknowledgements and status updates"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lockbox Provider"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update and expose payment status information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Network"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve payment status for reconciliation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disburser"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"optional-pre-match-payment-destinations","__idx":3},"children":["Optional: Pre-Match Payment Destinations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before submitting payments, you can use the Deluxe Directory Network (DDN) to retrieve lockbox information and validate potential destinations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment Network performs destination matching during payment processing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pre-matching can help:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve lockbox information before payment submission"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate destination information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identify destination issues before submission"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"submit-payment-instructions","__idx":4},"children":["Submit Payment Instructions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your application submits a payment file containing payment and remittance information to Payment Network."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After submission, you can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve processing errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve submitted payments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve payment status information"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/deluxe-payment-network/developer-resources/file-definitions"},"children":["File Definitions →"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fulfillment-and-processing","__idx":5},"children":["Fulfillment and Processing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After Payment Network receives a payment:"]},{"$$mdtype":"Tag","name":"NumberedList","attributes":{"type":"number","size":"medium"},"children":[{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":1,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment data is validated."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":2,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The appropriate destination is identified."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":3,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment information is sent to Deluxe Fulfillment."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":4,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment artifacts and check images are generated."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":5,"isLast":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment Network associates fulfillment artifacts with the original payment."]}]},{"$$mdtype":"Tag","name":"NumberedItem","attributes":{"type":"number","size":"medium","index":6,"isLast":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payment package is delivered to the lockbox provider."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The lockbox provider then processes the transaction and returns status information to Payment Network."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"monitor-payment-status","__idx":6},"children":["Monitor Payment Status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use Payment Network APIs to monitor processing outcomes and reconciliation status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Status information helps you:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm successful processing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitor payment progress"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Investigate exceptions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Support reconciliation activities"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/deluxe-payment-network/developer-resources/payment-statuses"},"children":["Payment Status →"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"handle-exceptions","__idx":7},"children":["Handle Exceptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payments may fail due to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validation issues"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Missing payment information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Destination-matching problems"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fulfillment issues"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Applications should monitor failed payments and implement procedures to investigate and resolve exceptions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/deluxe-payment-network/developer-resources/error-codes-messaging"},"children":["Error Codes & Messaging →"]}]}]},"headings":[{"value":"Plan Your Integration","id":"plan-your-integration","depth":1},{"value":"Payment Lifecycle","id":"payment-lifecycle","depth":3},{"value":"Responsibility Overview","id":"responsibility-overview","depth":3},{"value":"Optional: Pre-Match Payment Destinations","id":"optional-pre-match-payment-destinations","depth":3},{"value":"Submit Payment Instructions","id":"submit-payment-instructions","depth":3},{"value":"Fulfillment and Processing","id":"fulfillment-and-processing","depth":3},{"value":"Monitor Payment Status","id":"monitor-payment-status","depth":3},{"value":"Handle Exceptions","id":"handle-exceptions","depth":3}],"frontmatter":{"title":"Plan Your Integration","description":"Understand payment submission, processing, tracking, reconciliation, and fulfillment workflows before implementation.","audience":["external-developer"],"seo":{"title":"Plan Your Payment Network Integration","description":"Explore the payment lifecycle, APIs, participant responsibilities, reconciliation, and Print-and-Scan and Print-and-Mail fulfillment.","keywords":["payment lifecycle","implementation","Print + Scan","Print + Mail","DPN"]}},"lastModified":"2026-11-12T10:17:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/deluxe-payment-network/build-with-deluxe/implementation-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}