Foundation

Testing and sandbox

Foxpay custom REST integrations should be validated with test-mode credentials, controlled merchant fixtures, and end-to-end checkout rehearsal before live traffic is enabled.

Review quickstart Use sample assets

Supported testing workflow

Use merchant-specific test-mode API keys for integration and validation.
Confirm that `testMode` is returned as expected in initializer responses and stored in your order records.
Exercise the full backend-init, frontend-redirect, polling, and webhook lifecycle before enabling live traffic.
Validate payment-method availability and merchant configuration in the target environment before production rollout.

Testing discipline

Keep test and production credentials separate at all times.
Use deterministic fixture scenarios so engineering, QA, and support evaluate the same outcomes.
Do not reuse shared live credentials for validation work.
Record expected outcomes for each test scenario, especially when webhook replay or duplicate pending transactions are involved.

Fixture catalog

These scenarios cover the most important custom integration behaviors for implementation and operational testing.

Eligible custom merchant in test mode
Merchant blocked by missing or invalid KYC
Merchant blocked by payment-method availability rules
Duplicate pending transaction scenario
Webhook replay or duplicate delivery scenario