API, cashier & provider launches

PaymentIQ API & cashier integration checklist.

A visible cashier is one part of a working payment journey. Review the session, provider configuration and final transaction outcome together.

Independent guidance from Payment Expert. Not operated by, affiliated with or endorsed by PaymentIQ.

1. Define the payment journey

Write down the methods, currencies, markets and transaction types you intend to launch. Identify who owns the merchant application, cashier, PaymentIQ configuration and provider account. A simple ownership list makes an ambiguous failure easier to route to the right team.

  • Choose test or production explicitly and confirm the required permissions.
  • Identify the cashier or Hosted Fields approach and the supported versions in the current vendor documentation.
  • Agree the expected deposit, withdrawal and cancellation journeys that apply to the project.

2. Follow identity and session handling

Use the official documentation for the exact API contracts. Trace how your application creates and passes the required user and session context, and how expired or invalid sessions are handled. Test this from the actual merchant application rather than relying only on a standalone demo.

  • Verify the merchant and environment configuration used by each component.
  • Check the behaviour of an expired session, a repeated user action and an interrupted redirect.
  • Document which system is responsible for displaying the final result to the user.

3. Check methods, providers and routing

Confirm that the intended methods are available for the test customer and that the provider configuration matches the agreed setup. Review routing conditions and any fallback logic against the flows you actually want to run.

  • Check method availability for the selected market, currency and customer scenario.
  • Confirm provider prerequisites, including authentication and any relevant 3DS setup.
  • Record the expected route and compare it with the observed transaction path.

4. Test the complete outcome

Do not stop at a successful browser message. Follow the transaction through to the state recorded in the systems your operations team uses. Where results are asynchronous, define how pending transactions are recognised and followed up.

  • Cover success, refusal, timeout, abandonment and pending outcomes where supported.
  • Check that repeated clicks or interrupted journeys do not create unintended duplicate actions.
  • Keep test evidence, unresolved issues, launch responsibilities and a rollback decision with the handover.

Official implementation references

This checklist is an independent review framework, not an API specification. Use current vendor instructions for endpoint names, fields, credentials and version-specific behaviour.

Common questions

Is the checklist a replacement for the API documentation?

No. It helps structure a review. Endpoint details, supported fields and version behaviour must come from current vendor documentation.

What does an integration review deliver?

The scope can include configuration findings, agreed test scenarios and a documented issue list. We define the payment flow and deliverables before work starts.

Independent consulting

Need a second pair of eyes before launch?

Start with one provider or payment journey. We can agree a configuration review, test plan and documented list of issues to resolve.

Discuss an integration reviewSee the consulting services and deliverables

Resource links checked 11 September 2026

Keep exploring

Practical guidance for the people configuring, operating and analysing payments.

Analytics & reporting

PaymentIQ analytics & dashboards.

PaymentIQ analytics work includes building dashboards, checking whether their results are complete, and using the findings to improve operations. Start with the question, agree the metric definitions and trace the figures back to the source.

Troubleshooting & payment operations

How to investigate failed payments in PaymentIQ.

Start with the point where the payment stopped. Build a timeline and compare affected transactions with successful ones before proposing a configuration change.