Last updated

Testing Platform

The EPC Testing Platform can simulate a number of built-in payment scenarios for each supported scheme, allowing you to test your implementation of the various API operations. This self-service simulator tool is available to you at all times, so you can use it both during your development and for conformance testing after development is complete.

The corporate client and Electrum are the only entities involved during conformance testing. Electrum's testing platform will simulate the expected actions and responses of all other entities (industry and BankservAfrica) as would occur during the processing of a payment.

Test Outbound Payments

The diagram below shows the required integration for testing outbound payments.

outbound payment testing

Electrum's EPC API allows you to directly send requests to the Electrum testing platform in order to initiate a test transaction. You will also receive messages from the platform to inform you of the outcome of the test transaction.

  • You will need to populate certain fields in your test messages with specific values as indicated in the test pack. These values will identify which test scenario you wish to simulate and will inform transaction outcome.
  • If applicable for your sponsor bank: the testing platform will also simulate funds reservation, completions, or cancellations.

Test Inbound Payments

The diagram below shows the required integration for testing inbound payments.

inbound payment testing

As inbound payments are initiated by external industry parties to you, it is not possible to directly initiate a simulated inbound payment.

However, Electrum's EPC Testing API allows you to interact with our testing platform in order to:

  • Trigger certain scenarios that are normally initiated by the industry.
  • Request the outcome of a previously executed test transaction.
AUTHENTICATION

Connectivity to the API requires basic authentication. You will need to include the appropriate credentials (username and password) in order for the testing platform to accept messages that you send. These credentials will be supplied to you during your onboarding process.