velocity-pay-flutter/README.md

qpay-peak-flutter

Switch from Test to Live Environment

This project currently reads runtime API settings from assets/.env and loads Mastercard Checkout for web from web/index.html.

Use the checklist below before building for production.

1) Update API and simulation flags (assets/.env)

In assets/.env, make sure the active (uncommented) values are set for live:

BASE_URL=https://peakapi.qantra.co.zw/api
SIMULATE_PAYMENT_SUCCESS=false

Notes:

• Keep only one active BASE_URL line.
• SIMULATE_PAYMENT_SUCCESS must be false in live to avoid fake-success payment flows.

2) Update Mastercard Checkout script (web/index.html)

In web/index.html, switch the checkout script from test to live:

<script src="https://na.gateway.mastercard.com/static/checkout/checkout.min.js"></script>

And ensure the test script is not active:

<!-- <script src="https://test-gateway.mastercard.com/static/checkout/checkout.min.js"></script> -->

3) Quick pre-release verification

Before release, confirm:

• assets/.env points to the live API URL.
• assets/.env has SIMULATE_PAYMENT_SUCCESS=false.
• web/index.html loads na.gateway.mastercard.com (not test-gateway.mastercard.com).

Switch back to Test

To return to test:

• Restore the test BASE_URL in assets/.env.
• Set SIMULATE_PAYMENT_SUCCESS=true (only if needed for local testing).
• Re-enable the test checkout script in web/index.html.

Source of Truth

If environment settings change in future, update this README section together with assets/.env and web/index.html so release steps stay accurate.