Go-live checklist

Use the checklist below to ensure that your in-person payments flow is production-ready before launching.

Mollie Connect setup

• Fully onboard and verify your connected accounts via Mollie Connect.
• Store your OAuth access tokens securely (and ensure they are refreshed).
• Use the correct profileId when creating payments on behalf of connected accounts.
• Correctly configure your split payments, application fees and routing (if applicable).
• Equip your application to handle scenarios where a connected account revokes an OAuth token or lets it expire.

Payments

• Test your payment flow first using test keys, then use live API credentials, when you are ready to launch.
• Set the method to pointofsale for in-person payment creation.
• Configure your Webhook endpoints, make them publicly accessible, and return a 200 status.
• Your Webhook handler correctly processes all relevant payment statuses: paid, failed, canceled, and expired.
• Prepare to handle edge cases such as:
  • If a customer removes their card too early
  • Terminal loses its connectivity mid-transaction
  • Payments timeout or expire
• Implement Idempotency to prevent duplicated payments.
• Test full and partial refunds to ensure your system reflects them correctly.

API (server-side) integration

• Order and receive the terminals.
• Assign each terminal to the correct profile of the connected account.
• Connect terminals to the internet through Wi-Fi or Ethernet and verify that they show the active status in the Mollie Web App.
• Update each terminal's firmware.
• Test the full payment flow on each terminal model you plan to deploy.
• Plan for terminal provisioning at scale, including who assigns and manages terminals and how.
• Define a process for handling terminal hardware issues, such as replacements and returns.

Mobile app integration

• Install the Mollie Tap app on merchant devices.
• Verify that merchant devices meet minimum requirements, including Android version and NFC capability.
• Trigger the Mollie Tap app via Android intents from your Android app and handle the response.
• Test the full payment flow on representative devices your merchants will use.
• Show merchants how to log in to the Tap app with their Mollie account.
• Plan how to support merchants who have issues installing or using the Tap app.

Reconciliation and reporting

• Attribute payments correctly to connected accounts in the Mollie Web App.
• Reflect split payment amounts, application fees, and routing accurately in settlement reports.
• Reconcile in-person payments correctly in your internal systems, such as order management and accounting.
• Verify that refund and chargeback flows appear in your reporting.

Monitoring and support

• Monitor Webhook delivery and set up alerts for failures or delays.
• Log API responses and errors for debugging.
• Define an escalation path for:
  • Technical issues, such as API errors or webhook failures (your development team).
  • Terminal hardware issues, such as defective devices or connectivity issues (Mollie Support).
  • Merchant onboarding issues, such as verification or account status (Mollie Support or your onboarding team).
• Prepare merchant-facing documentation or help articles for common in-person payment workflows.
• Train your support team on basic troubleshooting for terminals and/or the Tap app.

Final validation

• Complete an end-to-end test in live mode with a real payment (you can refund it immediately after).
• Confirm that at least one connected account has completed a live transaction successfully.
• Review the Mollie Connect documentation for any platform-specific requirements you may have missed.

Ready to launch?

If you have checked every applicable item above, your integration is ready for production.
If you are still unsure about any process, reach out to your Mollie point of contact or contact Mollie Support.