Testing and troubleshooting

This page will cover some general information that can help you test and troubleshoot your integrations with Cashflows.

Integration account

You need different credentials for the integration and production environments, to create an integration account for testing purposes contact implementations@cashflows.com.

Integration environments

To test integrations before going live, we have integration environments available you can use to simulate different payment scenarios:

Cashflows Gateway API - https://secure-int.cashflows.com/gateway/
Payments API - https://integration.cashflows.com/payments/
Remote Auth API - https://secure-int.cashflows.com/gateway/remote_auth

Test cards

If you are testing card payments, you need to use a valid card number. Here are some test card numbers that you can use:

`cardNumber` value	Card Type	CVC	Expiry date
`4510400400099005`	Visa - Credit	123	Any future date within 10 years
`4510500400099002`	Visa - Credit	123	Any future date within 10 years
`4510800400099006`	Visa - Credit	123	Any future date within 10 years
`4000000000000002`	Visa - Credit	123	Any future date within 10 years
`8400182600000009`	Visa - Credit	123	Any future date within 10 years
`8400682600000008`	Visa - Debit	123	Any future date within 10 years
`8400682600011005`	Visa - Debit	123	Any future date within 10 years
`5400200400099009`	Mastercard - Credit	123	Any future date within 10 years
`5400300400099007`	Mastercard - Credit	123	Any future date within 10 years
`8500582600000009`	Mastercard - Credit	123	Any future date within 10 years
`5400100400099001`	Mastercard - Debit	123	Any future date within 10 years
`8500182600000008`	Mastercard - Debit	123	Any future date within 10 years
`340000000000009`	American Express - Credit	1234	Any future date within 10 years

Specify transaction result

You can use specific values as the cardHolderName to trigger specific results for the test transaction:

`cardHolderName` value	Response
`Luke Skywalker`	Success response
`Han Solo`	Challenge response
`Leia Skywalker`	Decoupled challenge
`Lando Calrissian`	Not authenticated
`Darth Maul`	Not authenticated (with proof of authentication)
`Darth Vader`	Failed for technical reasons
`Ben Kenobi`	Rejected by issuer
Left blank	Failed response

Error codes and warning messages

This section covers potential error code or messages and warnings you may receive from Cashflows services.

Error codes

Error	Description
`CannotRecurOnNonRecurringParent`	Cannot recur on a non recurring parent.
`CaptureAmountExceedsOriginalAuthorisation`	The total capture amount exceeds original authorised amount.
`GenericRejectionOfPayment`	Payment has been refused.
`GenericRejectionOfRefund`	Refund has been refused.
`GenericRejectionOfCredit`	Credit payment has been refused.
`InvalidCaptureStatus`	Capture has an invalid status.
`InvalidPaymentForRefund`	Unable to refund this payment.
`InvalidPaymentForCredit`	Unable to perform credit payment.
`InvalidPaymentStatus`	Payment has an invalid status.
`InvalidRefundStatus`	Refund has an invalid status.
`NonThreeDSecureNotAllowed`	Card payments without 3D Secure are not allowed.
`NoPaymentMethodSelected`	No payment method selected.
`OrderNumberNotUnique`	The supplied order reference is not unique.
`PaymentAlreadyFullyRefunded`	Payment has already been fully refunded.
`PaymentJobAlreadyFinal`	Payment job is already final.
`PaymentJobCanNotBeCancelled`	Payment job can not be cancelled.
`PaymentMethodCommunicationFailure`	Error while communicating.
`PaymentMethodNotAllowed`	Payment method not allowed.
`PaymentMethodRejection`	The payment method rejected the request.
`PaymentMethodLimitsExceeded`	Invalid amount for payment method.
`RecipientDetailFieldsFailedValidation`	The validation for recipient detail fields failed.
`RefundAmountExceedsOriginalAmount`	The total refund amount exceeds original paid amount.
`ThreeDSecureFailed`	3DSecure Authentication Failed - Payment cannot proceed.
`ThreeDSecureUnavailable`	3DSecure Authentication Unavailable - Payment cannot proceed.
`ThreeDSecureMethodPostCallbackConflict`	3DSecure Authentication Unavailable - Payment cannot proceed.
`InvalidCustomerReference`	Invalid customer reference provided.
`DirectAcquiringNotAllowed`	Direct card payments are not allowed.
`TooManyAttempts`	Too many attempts.
`SetParentFrameDomainsNotAllowed`	It is not allowed to set parent frame domains for embedding the payment page.
`RejectWithoutPaymentMethods`	Unable to create paymentjob without payment methods available.

Warning messages

Warning	Description
`UnexpectedPaymentStatus`	Payment has an unexpected status.
`MaximumNumberOfTokensReached`	The maximum number of stored tokens for a customer has been reached.
`PaymentPageReferenceDoesNotExists`	Supplied payment page reference does not exists.

Contact and Support

If you need additional support please contact one of the below teams. Phone lines are open Monday to Friday between 09:00 and 17:00 UTC.

Application and account setup

For information relating to your application or technical implementation, please use the contact details below:

Application progress - 0330 128 9855

Implementations - 0330 128 9855

Account support

To assist you in your day-to-day running of your account, please use the contact details below:

Customer support - 0330 128 9855

Technical support - 0330 128 9855