To test various scenarios, KOMOJU supports a handful of test card numbers and other payment method-specific inputs that simulate different outcomes.

Note that these only work in test mode. You're in test mode when you use the secret key of your test merchant. See Authentication.

If you're integrating KOMOJU using Hosted Fields or the WooCommerce plugin, you need to use 3-D Secure (3DS) aware cards, as these integrations support 3DS-aware cards only. If you see authentication failures continuously, please retry with the test cards which are clearly indicated as "3DS-aware". If you want to simulate a specific test scenario with 3DS-aware cards, please also refer to the section for Alternative Payment Methods.

Credit Card Numbers

WebMoney Numbers

Alternative Payment Methods

Not all payment methods accept number inputs. Additionally, testing 3DS currently does not work with the above card numbers. In these cases, you can use the following HTTP header to simulate error responses in test mode (in this example the scenario with insufficient funds will be emulated):

Komoju-Scenario: insufficient_funds

This header can be passed when creating payments, sessions, or customers.

• When passed during payment creation, the payment will immediately fail with the given error.
• When passed during session creation, all future attempts to pay will fail with the given error.
• When passed during customer creation, all attempts to use that customer to pay will fail with the given error.