Testing
Development
The below set of credentials allow you to test logging in to merchant accounts and simulate various scenarios.
| Scenario | Description | Username | Password |
|---|---|---|---|
| Successful authentication | Simulates a successful authentication to a merchant account. | user_good | pass_good |
| One-time password (OTP) | Simulates an authentication that requires an OTP. 1234 for a valid OTP and 0000 for an invalid OTP. | user_good | pass_otp |
| Invalid credentials | Simulates a failed authentication due to invalid credentials. | credentials | failed |
| Account failure | Simulates a failed authentication due to an issue with the user’s merchant account. | account | failed |
| Merchant failure | Simulates a failed authentication due to an issue with the merchant. | merchant | failed |
| Too many attempts | Simulates a failed authentication due to too many consecutive, failed login attempts. | too many attempts | failed |
| Card not supported | Simulates a failed card switch due to the card not being supported by the merchant. | card not supported | failed |
| Card expired | Simulates a failed card switch due to the card having insufficient funds (for debit & prepaid cards). | insufficient funds | failed |
| No subscription | Simulates a failed card switch due to the user’s lack of a paid subscription with the merchant. | subscription | failed |
| Subscription admin | Simulates a failed card switch due to the user’s account lacking the proper permissions to update the card. | subscription admin | failed |
| MassSwitcher with merchant accounts | Simulates a successful authentication to a user’s keychain with >0 merchant accounts. | keychain | pass_good |
| MassSwitcher with zero merchant accounts | Simulates a successful authentication to a user’s keychain with zero merchant accounts. | keychain | no_accounts |
Production
Below are a set of best practices when testing Knot in production.
- Ensure testing occurs from devices in the U.S. and with merchant accounts based in the U.S. International devices and accounts are not enabled.
- Replicate real-life behavior:
- Do not attempt to provision multiple cards to the same merchant account multiple consecutive times in a short period. The merchant’s fraud rules are likely to prevent this behavior.
- Do not attempt to provision the same card to multiple different accounts with the same merchant. Similar to the above, the merchant’s fraud rule are likely to prevent this behavior.
- Do not attempt to log in to the same merchant multiple consecutive times in a short time frame on the same device.
- Do not attempt to log into the a merchant account while on a company VPN.
- Ensure the proper personal information (beyond the card information) is being provided to Knot (typically in the call to Switch Card). Many merchants require first name, last name, billing address, and/or phone number to update a card-on-file. The billing address may need to pass Address Verification Service (AVS) checks by the merchant. This information can come from a number of different places depending on your integration with Knot or your server’s storage/retrieval of this information from other third parties (e.g. bank partner, processor, etc.).
- Ensure the card that is being sent to Knot is active (i.e. not locked/frozen) and has sufficient funds (if a debit card). Many merchants attempt a small authorization hold of
$0.01or$1.00on debit or prepaid cards. - If you are testing Knot’s web SDK, ensure you are not logged in to the merchant in another browser tab at the same time as when logging in via the SDK.
- If you choose to check if your card is actually provisioned to the merchant account after completing the flow in the Knot SDK:
- Allow a bit of time for the merchant account to update. Certain merchants can take a few minutes for the new card to be reflected in the account.
- Hard refresh the merchant account page and/or log out and log in again to see the newly provisioned card.
Testing
Development
The below set of credentials allow you to test logging in to merchant accounts and simulate various scenarios.
| Scenario | Description | Username | Password |
|---|---|---|---|
| Successful authentication | Simulates a successful authentication to a merchant account. | user_good | pass_good |
| One-time password (OTP) | Simulates an authentication that requires an OTP. 1234 for a valid OTP and 0000 for an invalid OTP. | user_good | pass_otp |
| Invalid credentials | Simulates a failed authentication due to invalid credentials. | credentials | failed |
| Account failure | Simulates a failed authentication due to an issue with the user’s merchant account. | account | failed |
| Merchant failure | Simulates a failed authentication due to an issue with the merchant. | merchant | failed |
| Too many attempts | Simulates a failed authentication due to too many consecutive, failed login attempts. | too many attempts | failed |
| Card not supported | Simulates a failed card switch due to the card not being supported by the merchant. | card not supported | failed |
| Card expired | Simulates a failed card switch due to the card having insufficient funds (for debit & prepaid cards). | insufficient funds | failed |
| No subscription | Simulates a failed card switch due to the user’s lack of a paid subscription with the merchant. | subscription | failed |
| Subscription admin | Simulates a failed card switch due to the user’s account lacking the proper permissions to update the card. | subscription admin | failed |
| MassSwitcher with merchant accounts | Simulates a successful authentication to a user’s keychain with >0 merchant accounts. | keychain | pass_good |
| MassSwitcher with zero merchant accounts | Simulates a successful authentication to a user’s keychain with zero merchant accounts. | keychain | no_accounts |
Production
Below are a set of best practices when testing Knot in production.
- Ensure testing occurs from devices in the U.S. and with merchant accounts based in the U.S. International devices and accounts are not enabled.
- Replicate real-life behavior:
- Do not attempt to provision multiple cards to the same merchant account multiple consecutive times in a short period. The merchant’s fraud rules are likely to prevent this behavior.
- Do not attempt to provision the same card to multiple different accounts with the same merchant. Similar to the above, the merchant’s fraud rule are likely to prevent this behavior.
- Do not attempt to log in to the same merchant multiple consecutive times in a short time frame on the same device.
- Do not attempt to log into the a merchant account while on a company VPN.
- Ensure the proper personal information (beyond the card information) is being provided to Knot (typically in the call to Switch Card). Many merchants require first name, last name, billing address, and/or phone number to update a card-on-file. The billing address may need to pass Address Verification Service (AVS) checks by the merchant. This information can come from a number of different places depending on your integration with Knot or your server’s storage/retrieval of this information from other third parties (e.g. bank partner, processor, etc.).
- Ensure the card that is being sent to Knot is active (i.e. not locked/frozen) and has sufficient funds (if a debit card). Many merchants attempt a small authorization hold of
$0.01or$1.00on debit or prepaid cards. - If you are testing Knot’s web SDK, ensure you are not logged in to the merchant in another browser tab at the same time as when logging in via the SDK.
- If you choose to check if your card is actually provisioned to the merchant account after completing the flow in the Knot SDK:
- Allow a bit of time for the merchant account to update. Certain merchants can take a few minutes for the new card to be reflected in the account.
- Hard refresh the merchant account page and/or log out and log in again to see the newly provisioned card.