{"__v":0,"_id":"5583290d81672a3900bb50b2","initVersion":{"_id":"555fbba928249c1900618a85","version":"1.0"},"project":"555fbba928249c1900618a82","user":{"_id":"55648cf93b87582b003ab8b1","username":"","name":"Chris Bunting"},"createdAt":"2015-06-18T20:24:45.707Z","fullscreen":false,"htmlmode":false,"html":"","body":"When Recurly encounters an error submitting a payment to your gateway, it parses the error code. From your gateway's error code, Recurly generates a friendly error message that can be displayed to your user and returns it in the XML error document. In addition, Recurly sets a code on the error document to let you know exactly why the transaction was declined. These errors can be returned when you are creating a new subscription, updating billing information, and processing a one-time transaction.\n[block:api-header]\n{\n  \"type\": \"basic\"\n}\n[/block]\nThe following error codes are return by Recurly. The description is specific to the error code to help you understand why it was declined.\n\n**approved**\n  _Customer Message_\n    Approved\n  _Merchant Message_\n  Approved\n\n**approved_fraud_review**\n  _Customer Message_\n    Approved\n  _Merchant Message_\n  Approved, flagged for fraud review in your payment gateway.\n\n**declined**\n  _Customer Message_\n    The transaction was declined. Please use a different card or contact your bank.\n  _Merchant Message_\n  The transaction was declined without specific information. Please contact your payment gateway for more details or ask the customer to contact their bank.\n\n**insufficient_funds**\n  _Customer Message_\n    The transaction was declined due to insufficient funds in your account. Please use a different card or contact your bank.\n  _Merchant Message_\n  The card has insufficient funds to cover the cost of the transaction.\n\n**temporary_hold**\n  _Customer Message_\n    Your card has a temporary hold. Please use a\n  different card or contact your bank.\n  _Merchant Message_\n  The issuing bank has a temporary hold on the card. This is known as a 'Do Not Honor' response.\n\n**too_many_attempts**\n  _Customer Message_\n    The transaction was declined. You have exceeded a reasonable number of attempts. Please wait a while before retrying your card, or try a different card.\n  _Merchant Message_\n  The transaction was declined because of too many authorization attempts.\n\n**call_issuer**\n  _Customer Message_\n    Your transaction was declined. Please contact your bank for further details or try another card.\n  _Merchant Message_\n  The transaction was declined by the payment gateway. Contact the card issuer for more details.\n\n**call_issuer_update_cardholder_data**\n  _Customer Message_\n    Please contact support: the payment system experienced an unspecified error with your card issuer.\n  _Merchant Message_\n  The transaction was declined by the payment gateway. Contact the card issuer for more details.\n\n**paypal_primary_declined**\n  _Customer Message_\n    Your primary funding source was declined. Please try again or update your billing information with PayPal.\n  _Merchant Message_\n  The primary funding source failed but the transaction can be attempted again. The next attempt will use the alternate funding source.\n\n**paypal_declined_use_alternate**\n  _Customer Message_\n    Your primary funding source was declined. Please try again to use your secondary funding source.\n  _Merchant Message_\n  The primary funding source failed but the transaction can be attempted again. The next attempt will use the alternate funding source.\n\n**declined_security_code**\n  _Customer Message_\n    The security code you entered does not match. Please update the CVV and try again.\n  _Merchant Message_\n  The payment gateway declined the transaction because the security code (CVV) did not match.\n\n**declined_exception**\n  _Customer Message_\n    The transaction was declined. Please try again or try another card.\n  _Merchant Message_\n  An exception occurred with your payment gateway while processing this transaction. The transaction may be missing required information or the information is not properly formatted. Please contact your gateway for details.\n\n**declined_missing_data**\n  _Customer Message_\n    Your billing information is missing some required\n  information.\n  _Merchant Message_\n  The payment gateway declined the transaction for missing a required field. Please verify your configuration with Recurly and your gateway is correct. You may need to require more address information.\n\n**invalid_data**\n  _Customer Message_\n    The transaction was declined due to invalid\n  data.\n  _Merchant Message_\n  The payment gateway declined the transaction due invalid data. Please check the response details for more information.\n\n**invalid_email**\n  _Customer Message_\n    Your email address is not valid.\n  _Merchant Message_\n  The payment gateway requires a valid email address for this transaction.\n\n**declined_card_number**\n  _Customer Message_\n    Your card number is not valid. Please update your card number.\n  _Merchant Message_\n  The credit card number is not valid. The customer needs to try a different number.\n\n**invalid_card_number**\n  _Customer Message_\n    Your card number is not valid. Please update your card number.\n  _Merchant Message_\n  The credit card number is not valid. The customer needs to try a different number.\n\n**invalid_account_number**\n  _Customer Message_\n    Your account number is not valid. Please update your account number.\n  _Merchant Message_\n  The account number is not valid. The customer needs to try a different number.\n\n**gateway_token_not_found**\n  _Customer Message_\n    Your payment details were not found. Please update your billing information.\n  _Merchant Message_\n  The payment details were not found in your payment gateway. The customer needs to update their billing information.\n\n**expired_card**\n  _Customer Message_\n    Your credit card is expired, please update your\n  card.\n  _Merchant Message_\n  The payment gateway declined the transaction because the expiration date is expired or does not match.\n\n**declined_expiration_date**\n  _Customer Message_\n    Your expiration date is invalid or does not match.\n  _Merchant Message_\n  The payment gateway declined the transaction because the expiration date is expired or does not match.\n\n**exceeds_daily_limit**\n  _Customer Message_\n    The transaction exceeds your daily approval limit. Please contact your bank or try another card.\n  _Merchant Message_\n  The transaction exceeds the cardholder's daily approval limit.\n\n**invalid_merchant_type**\n  _Customer Message_\n    Your card is not allowed to complete this transaction. Please try another card.\n  _Merchant Message_\n  The card is not allowed to make purchases from you (e.g. a Travel only card trying to purchase electronics).\n\n**invalid_transaction**\n  _Customer Message_\n    Your card is not allowed to complete this transaction. Please contact your bank or try another card.\n  _Merchant Message_\n  The card type cannot perform the transaction type. The card is likely restricted. The customer needs to contact their bank for details.\n\n**invalid_issuer**\n  _Customer Message_\n    Your card number is not valid. Please try another card or contact your bank.\n  _Merchant Message_\n  The card number references an issuer (bank) that does not exist.  It is not a valid card number.\n\n**card_type_not_accepted**\n  _Customer Message_\n    Your card type is not accepted. Please try another card.\n  _Merchant Message_\n  Your merchant account does not accept this card type or specific transaction.\n\n**payment_not_accepted**\n  _Customer Message_\n    Your payment type is not accepted. Please try another card.\n  _Merchant Message_\n  Your merchant account does not accept this payment type or specific transaction.\n\n**restricted_card**\n  _Customer Message_\n    Your card cannot be accepted. Please contact your issuing bank for details or try another card.\n  _Merchant Message_\n  The card number has restrictions that prevent it from being used with your merchant account. It is likely a corporate card. The customer needs to use a different card.\n\n**restricted_card_chargeback**\n  _Customer Message_\n    Your card cannot be accepted. Please contact your issuing bank for details or try another card.\n  _Merchant Message_\n  The card has a restriction preventing approval if there are any chargebacks against it.\n\n**card_not_activated**\n  _Customer Message_\n    Your card has not been activated.  Please call your bank to activate your card and try again.\n  _Merchant Message_\n  The card is brand new and has not been activated yet.\n\n**deposit_referenced_chargeback**\n  _Customer Message_\n    The refund cannot be processed because of a chargeback.\n  _Merchant Message_\n  The deposit is already referenced by a chargeback; therefore, a refund cannot be processed against this transaction.\n\n**customer_canceled_transaction**\n  _Customer Message_\n    You canceled the transaction after it was approved. Please update your billing information to authorize a new transaction.\n  _Merchant Message_\n  The cardholder requested this particular payment be stopped before it settled.\n\n**cardholder_requested_stop**\n  _Customer Message_\n    You requested recurring payments no longer be accepted on this card. Please update your billing information.\n  _Merchant Message_\n  The cardholder requested recurring payments be stopped. This card will no longer work with your merchant account.\n\n**no_billing_information**\n  _Customer Message_\n    Your billing information is not on file. Please add your billing information.\n  _Merchant Message_\n  This transaction cannot be processed because Recurly has no billing information for this account.\n\n**paypal_invalid_billing_agreement**\n  _Customer Message_\n    Your PayPal billing agreement is no longer valid. Please update your billing information.\n  _Merchant Message_\n  The billing agreement is no longer valid. The customer may have canceled the agreement.\n\n**paypal_hard_decline**\n  _Customer Message_\n    Your primary funding source was declined. Please update your billing information with PayPal or try again.\n  _Merchant Message_\n  PayPal failed to run the transaction with the primary funding source.\n\n**paypal_account_issue**\n  _Customer Message_\n    Your primary funding source was declined. Please update your billing information with PayPal or try again.\n  _Merchant Message_\n  PayPal indicated the transaction failed due to an issue with the buyer account.\n\n**fraud_address**\n  _Customer Message_\n    Your billing address does not match the address on your account. Please fix your address or contact your bank.\n  _Merchant Message_\n  The payment gateway declined the transaction because the billing address did not match.\n\n**fraud_security_code**\n  _Customer Message_\n    The security code you entered does not match. Please update the CVV and try again.\n  _Merchant Message_\n  The payment gateway declined the transaction because the security code (CVV) did not match.\n\n**fraud_stolen_card**\n  _Customer Message_\n    The transaction was declined. Please use a different card or contact your bank.\n  _Merchant Message_\n  The card has been designated as lost or stolen; contact the issuing bank.\n\n**fraud_ip_address**\n  _Customer Message_\n    The transaction was declined. Please contact support.\n  _Merchant Message_\n  The payment gateway declined the transaction because it originated from an IP address known for fraudulent transactions.\n\n**fraud_gateway**\n  _Customer Message_\n    The transaction was declined. Please use a different card or contact your bank.\n  _Merchant Message_\n  The payment gateway declined the transaction because it originated from an IP address known for fraudulent transactions.\n\n**fraud_too_many_attempts**\n  _Customer Message_\n    You attempted to use this card too many times. Please wait 15 minutes before trying again, or use a different card.\n  _Merchant Message_\n  The card number was used unsuccessfully too many times consecutively.  The cardholder must wait before the card number will work again.\n\n**fraud_advanced_verification**\n  _Customer Message_\n    The transaction was declined. Please use a different card or contact your bank.\n  _Merchant Message_\n  The payment gateway declined the transaction because it failed the advanced verification.\n\n**invalid_gateway_configuration**\n  _Customer Message_\n    Please contact support: the payment system is configured incorrectly. Your card was not charged.\n  _Merchant Message_\n  Your payment gateway is not configured correctly. Please contact your payment gateway for more information.\n\n**invalid_login**\n  _Customer Message_\n    Please contact support: the payment system is configured incorrectly. Your card was not charged.\n  _Merchant Message_\n  Your payment gateway login is incorrect. Please check your login credentials.\n\n**gateway_unavailable**\n  _Customer Message_\n    Please contact support: the payment system experienced an unspecified error with your card issuer.\n  _Merchant Message_\n  The payment gateway was unavailable for transaction. Contact your payment gateway for more details.\n\n**processor_unavailable**\n  _Customer Message_\n    Please contact support: the payment system experienced an unspecified error with your card issuer.\n  _Merchant Message_\n  The payment processor was unavailable for the transaction. Contact your payment gateway for more details.\n\n**issuer_unavailable**\n  _Customer Message_\n    Please contact support: the payment system experienced an unspecified error with your card issuer.\n  _Merchant Message_\n  The issuer was unavailable to authorize the transaction. Contact the card issuer or your payment gateway for more\n  details.\n\n**gateway_timeout**\n  _Customer Message_\n    Please contact support: the payment system did not respond in time to process your transaction.\n  _Merchant Message_\n  The payment gateway timed out while processing this transaction. Please verify that the transaction did not process. Contact your payment gateway for more details.\n\n**gateway_error**\n  _Customer Message_\n    An error occurred while processing your transaction. Please contact support.\n  _Merchant Message_\n  The payment gateway encountered an unknown error.\n  Please contact your payment gateway for details.\n\n**contact_gateway**\n  _Customer Message_\n    Please contact support: the payment system experienced an unspecified error with your card issuer.\n  _Merchant Message_\n  This error requires you to contact your payment gateway for a resolution.\n\n**try_again**\n  _Customer Message_\n    The payment system would like you to please try again.\n  _Merchant Message_\n  The payment gateway is too busy or experienced another temporary problem, and cannot process the transaction at the moment. Please try again.\n\n**cvv_required**\n  _Customer Message_\n    Please contact support: the payment system experienced an error. Your card was not charged.\n  _Merchant Message_\n  Your payment gateway account is requiring the security code (CVV) for all transactions. Recurly cannot process recurring/subscription transactions. Please contact your payment gateway to disable the CVV requirement.\n\n**currency_not_supported**\n  _Customer Message_\n    Please contact support: the requested currency is not supported for this merchant. Your card was not charged.\n  _Merchant Message_\n  The currency configured on your Recurly account is not accepted by your gateway. Please use a supported currency or contact your payment gateway for more details.\n\n**ssl_error**\n  _Customer Message_\n    Please contact support: the payment system experienced an error. Your card was not charged.\n  _Merchant Message_\n  Your PEM certificate is configured incorrectly. Recurly cannot communicate with your payment gateway.\n\n**zero_dollar_auth_not_supported**\n  _Customer Message_\n    Please contact support: the payment system experienced an error while authorizing your card. Your card was not charged.\n  _Merchant Message_\n  Zero dollar authorizations are not supported for this card type or by your payment processor.\n\n**no_gateway**\n  _Customer Message_\n    Please contact support: the payment system experienced an unspecified error with your card issuer.\n  _Merchant Message_\n  There is no available payment gateway on your account capable of processing this transaction.\n\n**ach_transactions_not_supported**\n  _Customer Message_\n    Please contact support: ACH/EFT transfers are not supported.\n  _Merchant Message_\n  ACH/EFT transfers are not enabled on your account.\n\n**three_d_secure_not_supported**\n  _Customer Message_\n    Please contact support: the payment system experienced an error. Your card was not charged.\n  _Merchant Message_\n  3D Secure was attempted but is not enabled on your account.\n\n**transaction_not_found**\n  _Customer Message_\n    The original transaction was not found.\n  _Merchant Message_\n  The original transaction was not found.\n\n**transaction_settled**\n  _Customer Message_\n    The transaction has already been settled, so it cannot be voided. Please try a refund.\n  _Merchant Message_\n  The transaction has already been settled, so it cannot be voided. Please try a refund.\n\n**transaction_already_voided**\n  _Customer Message_\n    The transaction has already been voided, so it cannot be settled or refunded.\n  _Merchant Message_\n  The transaction has already been voided, so it cannot be settled or refunded.\n\n**transaction_failed_to_settled**\n  _Customer Message_\n    The transaction did not settle successfully. Please update your billing information.\n  _Merchant Message_\n  The transaction authorized successfully, but failed to settle. The settlement request may have expired or have been canceled.\n\n**payment_cannot_void_authorization**\n  _Customer Message_\n    An error occurred while voiding your payment authorization. Please contact support.\n  _Merchant Message_\n  The credit exceeds the amount of the original transaction.\n\n**partial_credits_not_supported**\n  _Customer Message_\n    An error occurred while refunding your transaction. Please contact support.\n  _Merchant Message_\n  Your payment gateway does not support partially refunding a transaction. Please refund the entire amount.\n\n**cannot_refund_unsettled_transactions**\n  _Customer Message_\n    An error occurred while refunding your transaction. Please contact support.\n  _Merchant Message_\n  The transaction has not settled yet, so it cannot be refunded. Please try voiding the transaction instead.\n\n**transaction_cannot_be_refunded**\n  _Customer Message_\n    The transaction cannot be refunded. Please contact support.\n  _Merchant Message_\n  The transaction cannot be refunded. Please contact your payment gateway for details.\n\n**transaction_cannot_be_voided**\n  _Customer Message_\n    The transaction cannot be voided. Please contact support.\n  _Merchant Message_\n  The transaction cannot be void. It may have settled, already been voided, or otherwise be illegible for voiding. Please contact your payment gateway for details.\n\n**total_credit_exceeds_capture**\n  _Customer Message_\n    An error occurred while refunding your transaction. Please contact support.\n  _Merchant Message_\n  The credit exceeds the amount of the original transaction.\n\n**authorization_expired**\n  _Customer Message_\n    An error occurred while processing your transaction. Please contact update your billing information.\n  _Merchant Message_\n  The purchase authorization expired and can no longer be used to collect payment. Please attempt another transaction.\n\n**authorization_already_captured**\n  _Customer Message_\n    An error occurred while processing your transaction. Please contact support.\n  _Merchant Message_\n  The purchase amount was already captured. This authorization cannot be used again.\n\n**authorization_amount_depleted**\n  _Customer Message_\n    An error occurred while processing your transaction. Please contact support.\n  _Merchant Message_\n  The amount of purchases exceeds the original authorized amount.  You cannot collect more money using this authorization.\n\n**recurly_error**\n  _Customer Message_\n    An error occurred while processing your transaction. Please contact support.\n  _Merchant Message_\n  An error occurred while processing the transaction. Please contact Recurly support.\n\n**unknown**\n  _Customer Message_\n    The transaction was declined or failed for an unknown reason. Please try again or contact support.\n  _Merchant Message_\n  The transaction was declined or failed for an unknown reason. Please try again or contact support.\n\n**api_error**\n  _Customer Message_\n    An error occurred while processing your transaction. Please contact support.\n  _Merchant Message_\n  The payment gateway returned an error code that usually indicates its API specs have changed. Please contact Recurly support.\n\n**duplicate_transaction**\n  _Customer Message_\n    A similar transaction was recently submitted. Please wait a few minutes and try again.\n  _Merchant Message_\n  A transaction was recently submitted with the same Invoice Number, or the same card number and amount. The payment gateway refused to process this transaction in order to prevent a duplicate transaction.\n\n**recurly_failed_to_get_token**\n  _Customer Message_\n    An error occurred while initializing the transaction. Please try again.\n  _Merchant Message_\n  An error occurred while initializing the transaction. Please try again.\n\n**recurly_token_not_found**\n  _Customer Message_\n    An error occurred while processing your transaction. Please contact support.\n  _Merchant Message_\n  An error occurred while processing the transaction. Please contact Recurly support.\n\nBelow is an example XML response for the fraud_security_code error:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<errors>\\n  <transaction_error>\\n    <error_code>fraud_security_code</error_code>\\n    <error_category>fraud</error_category>\\n    <merchant_message>The payment gateway declined the transaction because the security code (CVV) did not match.</merchant_message>\\n    <customer_message>The security code you entered does not match. Please update the CVV and try again.</customer_message>\\n    <gateway_error_code>301</gateway_error_code>\\n  </transaction_error>\\n  <error field=\\\"transaction.account.billing_info.verification_value\\\" symbol=\\\"declined_bad\\\">did not match</error>\\n  <transaction href=\\\"https://your-subdomain.recurly.com/v2/transactions/3d1c6aa86e3d447eb0f3b4a6e3e074d9\\\" type=\\\"credit_card\\\">\\n    <uuid>3d1c6aa86e3d447eb0f3b4a6e3e074d9</uuid>\\n    <action>purchase</action>\\n    <amount_in_cents type=\\\"integer\\\">4900</amount_in_cents>\\n    <tax_in_cents type=\\\"integer\\\">0</tax_in_cents>\\n    <currency>USD</currency>\\n    <status>declined</status>\\n    <reference nil=\\\"nil\\\"></reference>\\n    <test type=\\\"boolean\\\">true</test>\\n    <voidable type=\\\"boolean\\\">false</voidable>\\n    <refundable type=\\\"boolean\\\">false</refundable>\\n    <transaction_error>\\n      <error_code>fraud_security_code</error_code>\\n      <error_category>fraud</error_category>\\n      <merchant_message>The payment gateway declined the transaction because the security code (CVV) did not match.</merchant_message>\\n      <customer_message>The security code you entered does not match. Please update the CVV and try again.</customer_message>\\n      <gateway_error_code>123</gateway_error_code>\\n    </transaction_error>\\n    <cvv_result code=\\\"N\\\">No Match</cvv_result>\\n    <avs_result code=\\\"D\\\">Street address and postal code match.</avs_result>\\n    <avs_result_street>Y</avs_result_street>\\n    <avs_result_postal>Y</avs_result_postal>\\n    <created_at type=\\\"datetime\\\">2011-10-17T17:24:53Z</created_at>\\n    <details>\\n      <account>\\n        <account_code>1</account_code>\\n        <first_name nil=\\\"nil\\\"></first_name>\\n        <last_name nil=\\\"nil\\\"></last_name>\\n        <company nil=\\\"nil\\\"></company>\\n        <email>verena@example.com</email>\\n        <billing_info type=\\\"credit_card\\\">\\n          <first_name nil=\\\"nil\\\"></first_name>\\n          <last_name nil=\\\"nil\\\"></last_name>\\n          <address1 nil=\\\"nil\\\"></address1>\\n          <address2 nil=\\\"nil\\\"></address2>\\n          <city nil=\\\"nil\\\"></city>\\n          <state nil=\\\"nil\\\"></state>\\n          <zip nil=\\\"nil\\\"></zip>\\n          <country nil=\\\"nil\\\"></country>\\n          <phone nil=\\\"nil\\\"></phone>\\n          <vat_number nil=\\\"nil\\\"></vat_number>\\n          <card_type>Visa</card_type>\\n          <year type=\\\"integer\\\">2015</year>\\n          <month type=\\\"integer\\\">11</month>\\n          <first_six>400000</first_six>\\n          <last_four>0101</last_four>\\n        </billing_info>\\n      </account>\\n    </details>\\n  </transaction>\\n</errors>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","slug":"transaction-errors","title":"Transaction Errors"}

Transaction Errors


When Recurly encounters an error submitting a payment to your gateway, it parses the error code. From your gateway's error code, Recurly generates a friendly error message that can be displayed to your user and returns it in the XML error document. In addition, Recurly sets a code on the error document to let you know exactly why the transaction was declined. These errors can be returned when you are creating a new subscription, updating billing information, and processing a one-time transaction. [block:api-header] { "type": "basic" } [/block] The following error codes are return by Recurly. The description is specific to the error code to help you understand why it was declined. **approved** _Customer Message_ Approved _Merchant Message_ Approved **approved_fraud_review** _Customer Message_ Approved _Merchant Message_ Approved, flagged for fraud review in your payment gateway. **declined** _Customer Message_ The transaction was declined. Please use a different card or contact your bank. _Merchant Message_ The transaction was declined without specific information. Please contact your payment gateway for more details or ask the customer to contact their bank. **insufficient_funds** _Customer Message_ The transaction was declined due to insufficient funds in your account. Please use a different card or contact your bank. _Merchant Message_ The card has insufficient funds to cover the cost of the transaction. **temporary_hold** _Customer Message_ Your card has a temporary hold. Please use a different card or contact your bank. _Merchant Message_ The issuing bank has a temporary hold on the card. This is known as a 'Do Not Honor' response. **too_many_attempts** _Customer Message_ The transaction was declined. You have exceeded a reasonable number of attempts. Please wait a while before retrying your card, or try a different card. _Merchant Message_ The transaction was declined because of too many authorization attempts. **call_issuer** _Customer Message_ Your transaction was declined. Please contact your bank for further details or try another card. _Merchant Message_ The transaction was declined by the payment gateway. Contact the card issuer for more details. **call_issuer_update_cardholder_data** _Customer Message_ Please contact support: the payment system experienced an unspecified error with your card issuer. _Merchant Message_ The transaction was declined by the payment gateway. Contact the card issuer for more details. **paypal_primary_declined** _Customer Message_ Your primary funding source was declined. Please try again or update your billing information with PayPal. _Merchant Message_ The primary funding source failed but the transaction can be attempted again. The next attempt will use the alternate funding source. **paypal_declined_use_alternate** _Customer Message_ Your primary funding source was declined. Please try again to use your secondary funding source. _Merchant Message_ The primary funding source failed but the transaction can be attempted again. The next attempt will use the alternate funding source. **declined_security_code** _Customer Message_ The security code you entered does not match. Please update the CVV and try again. _Merchant Message_ The payment gateway declined the transaction because the security code (CVV) did not match. **declined_exception** _Customer Message_ The transaction was declined. Please try again or try another card. _Merchant Message_ An exception occurred with your payment gateway while processing this transaction. The transaction may be missing required information or the information is not properly formatted. Please contact your gateway for details. **declined_missing_data** _Customer Message_ Your billing information is missing some required information. _Merchant Message_ The payment gateway declined the transaction for missing a required field. Please verify your configuration with Recurly and your gateway is correct. You may need to require more address information. **invalid_data** _Customer Message_ The transaction was declined due to invalid data. _Merchant Message_ The payment gateway declined the transaction due invalid data. Please check the response details for more information. **invalid_email** _Customer Message_ Your email address is not valid. _Merchant Message_ The payment gateway requires a valid email address for this transaction. **declined_card_number** _Customer Message_ Your card number is not valid. Please update your card number. _Merchant Message_ The credit card number is not valid. The customer needs to try a different number. **invalid_card_number** _Customer Message_ Your card number is not valid. Please update your card number. _Merchant Message_ The credit card number is not valid. The customer needs to try a different number. **invalid_account_number** _Customer Message_ Your account number is not valid. Please update your account number. _Merchant Message_ The account number is not valid. The customer needs to try a different number. **gateway_token_not_found** _Customer Message_ Your payment details were not found. Please update your billing information. _Merchant Message_ The payment details were not found in your payment gateway. The customer needs to update their billing information. **expired_card** _Customer Message_ Your credit card is expired, please update your card. _Merchant Message_ The payment gateway declined the transaction because the expiration date is expired or does not match. **declined_expiration_date** _Customer Message_ Your expiration date is invalid or does not match. _Merchant Message_ The payment gateway declined the transaction because the expiration date is expired or does not match. **exceeds_daily_limit** _Customer Message_ The transaction exceeds your daily approval limit. Please contact your bank or try another card. _Merchant Message_ The transaction exceeds the cardholder's daily approval limit. **invalid_merchant_type** _Customer Message_ Your card is not allowed to complete this transaction. Please try another card. _Merchant Message_ The card is not allowed to make purchases from you (e.g. a Travel only card trying to purchase electronics). **invalid_transaction** _Customer Message_ Your card is not allowed to complete this transaction. Please contact your bank or try another card. _Merchant Message_ The card type cannot perform the transaction type. The card is likely restricted. The customer needs to contact their bank for details. **invalid_issuer** _Customer Message_ Your card number is not valid. Please try another card or contact your bank. _Merchant Message_ The card number references an issuer (bank) that does not exist. It is not a valid card number. **card_type_not_accepted** _Customer Message_ Your card type is not accepted. Please try another card. _Merchant Message_ Your merchant account does not accept this card type or specific transaction. **payment_not_accepted** _Customer Message_ Your payment type is not accepted. Please try another card. _Merchant Message_ Your merchant account does not accept this payment type or specific transaction. **restricted_card** _Customer Message_ Your card cannot be accepted. Please contact your issuing bank for details or try another card. _Merchant Message_ The card number has restrictions that prevent it from being used with your merchant account. It is likely a corporate card. The customer needs to use a different card. **restricted_card_chargeback** _Customer Message_ Your card cannot be accepted. Please contact your issuing bank for details or try another card. _Merchant Message_ The card has a restriction preventing approval if there are any chargebacks against it. **card_not_activated** _Customer Message_ Your card has not been activated. Please call your bank to activate your card and try again. _Merchant Message_ The card is brand new and has not been activated yet. **deposit_referenced_chargeback** _Customer Message_ The refund cannot be processed because of a chargeback. _Merchant Message_ The deposit is already referenced by a chargeback; therefore, a refund cannot be processed against this transaction. **customer_canceled_transaction** _Customer Message_ You canceled the transaction after it was approved. Please update your billing information to authorize a new transaction. _Merchant Message_ The cardholder requested this particular payment be stopped before it settled. **cardholder_requested_stop** _Customer Message_ You requested recurring payments no longer be accepted on this card. Please update your billing information. _Merchant Message_ The cardholder requested recurring payments be stopped. This card will no longer work with your merchant account. **no_billing_information** _Customer Message_ Your billing information is not on file. Please add your billing information. _Merchant Message_ This transaction cannot be processed because Recurly has no billing information for this account. **paypal_invalid_billing_agreement** _Customer Message_ Your PayPal billing agreement is no longer valid. Please update your billing information. _Merchant Message_ The billing agreement is no longer valid. The customer may have canceled the agreement. **paypal_hard_decline** _Customer Message_ Your primary funding source was declined. Please update your billing information with PayPal or try again. _Merchant Message_ PayPal failed to run the transaction with the primary funding source. **paypal_account_issue** _Customer Message_ Your primary funding source was declined. Please update your billing information with PayPal or try again. _Merchant Message_ PayPal indicated the transaction failed due to an issue with the buyer account. **fraud_address** _Customer Message_ Your billing address does not match the address on your account. Please fix your address or contact your bank. _Merchant Message_ The payment gateway declined the transaction because the billing address did not match. **fraud_security_code** _Customer Message_ The security code you entered does not match. Please update the CVV and try again. _Merchant Message_ The payment gateway declined the transaction because the security code (CVV) did not match. **fraud_stolen_card** _Customer Message_ The transaction was declined. Please use a different card or contact your bank. _Merchant Message_ The card has been designated as lost or stolen; contact the issuing bank. **fraud_ip_address** _Customer Message_ The transaction was declined. Please contact support. _Merchant Message_ The payment gateway declined the transaction because it originated from an IP address known for fraudulent transactions. **fraud_gateway** _Customer Message_ The transaction was declined. Please use a different card or contact your bank. _Merchant Message_ The payment gateway declined the transaction because it originated from an IP address known for fraudulent transactions. **fraud_too_many_attempts** _Customer Message_ You attempted to use this card too many times. Please wait 15 minutes before trying again, or use a different card. _Merchant Message_ The card number was used unsuccessfully too many times consecutively. The cardholder must wait before the card number will work again. **fraud_advanced_verification** _Customer Message_ The transaction was declined. Please use a different card or contact your bank. _Merchant Message_ The payment gateway declined the transaction because it failed the advanced verification. **invalid_gateway_configuration** _Customer Message_ Please contact support: the payment system is configured incorrectly. Your card was not charged. _Merchant Message_ Your payment gateway is not configured correctly. Please contact your payment gateway for more information. **invalid_login** _Customer Message_ Please contact support: the payment system is configured incorrectly. Your card was not charged. _Merchant Message_ Your payment gateway login is incorrect. Please check your login credentials. **gateway_unavailable** _Customer Message_ Please contact support: the payment system experienced an unspecified error with your card issuer. _Merchant Message_ The payment gateway was unavailable for transaction. Contact your payment gateway for more details. **processor_unavailable** _Customer Message_ Please contact support: the payment system experienced an unspecified error with your card issuer. _Merchant Message_ The payment processor was unavailable for the transaction. Contact your payment gateway for more details. **issuer_unavailable** _Customer Message_ Please contact support: the payment system experienced an unspecified error with your card issuer. _Merchant Message_ The issuer was unavailable to authorize the transaction. Contact the card issuer or your payment gateway for more details. **gateway_timeout** _Customer Message_ Please contact support: the payment system did not respond in time to process your transaction. _Merchant Message_ The payment gateway timed out while processing this transaction. Please verify that the transaction did not process. Contact your payment gateway for more details. **gateway_error** _Customer Message_ An error occurred while processing your transaction. Please contact support. _Merchant Message_ The payment gateway encountered an unknown error. Please contact your payment gateway for details. **contact_gateway** _Customer Message_ Please contact support: the payment system experienced an unspecified error with your card issuer. _Merchant Message_ This error requires you to contact your payment gateway for a resolution. **try_again** _Customer Message_ The payment system would like you to please try again. _Merchant Message_ The payment gateway is too busy or experienced another temporary problem, and cannot process the transaction at the moment. Please try again. **cvv_required** _Customer Message_ Please contact support: the payment system experienced an error. Your card was not charged. _Merchant Message_ Your payment gateway account is requiring the security code (CVV) for all transactions. Recurly cannot process recurring/subscription transactions. Please contact your payment gateway to disable the CVV requirement. **currency_not_supported** _Customer Message_ Please contact support: the requested currency is not supported for this merchant. Your card was not charged. _Merchant Message_ The currency configured on your Recurly account is not accepted by your gateway. Please use a supported currency or contact your payment gateway for more details. **ssl_error** _Customer Message_ Please contact support: the payment system experienced an error. Your card was not charged. _Merchant Message_ Your PEM certificate is configured incorrectly. Recurly cannot communicate with your payment gateway. **zero_dollar_auth_not_supported** _Customer Message_ Please contact support: the payment system experienced an error while authorizing your card. Your card was not charged. _Merchant Message_ Zero dollar authorizations are not supported for this card type or by your payment processor. **no_gateway** _Customer Message_ Please contact support: the payment system experienced an unspecified error with your card issuer. _Merchant Message_ There is no available payment gateway on your account capable of processing this transaction. **ach_transactions_not_supported** _Customer Message_ Please contact support: ACH/EFT transfers are not supported. _Merchant Message_ ACH/EFT transfers are not enabled on your account. **three_d_secure_not_supported** _Customer Message_ Please contact support: the payment system experienced an error. Your card was not charged. _Merchant Message_ 3D Secure was attempted but is not enabled on your account. **transaction_not_found** _Customer Message_ The original transaction was not found. _Merchant Message_ The original transaction was not found. **transaction_settled** _Customer Message_ The transaction has already been settled, so it cannot be voided. Please try a refund. _Merchant Message_ The transaction has already been settled, so it cannot be voided. Please try a refund. **transaction_already_voided** _Customer Message_ The transaction has already been voided, so it cannot be settled or refunded. _Merchant Message_ The transaction has already been voided, so it cannot be settled or refunded. **transaction_failed_to_settled** _Customer Message_ The transaction did not settle successfully. Please update your billing information. _Merchant Message_ The transaction authorized successfully, but failed to settle. The settlement request may have expired or have been canceled. **payment_cannot_void_authorization** _Customer Message_ An error occurred while voiding your payment authorization. Please contact support. _Merchant Message_ The credit exceeds the amount of the original transaction. **partial_credits_not_supported** _Customer Message_ An error occurred while refunding your transaction. Please contact support. _Merchant Message_ Your payment gateway does not support partially refunding a transaction. Please refund the entire amount. **cannot_refund_unsettled_transactions** _Customer Message_ An error occurred while refunding your transaction. Please contact support. _Merchant Message_ The transaction has not settled yet, so it cannot be refunded. Please try voiding the transaction instead. **transaction_cannot_be_refunded** _Customer Message_ The transaction cannot be refunded. Please contact support. _Merchant Message_ The transaction cannot be refunded. Please contact your payment gateway for details. **transaction_cannot_be_voided** _Customer Message_ The transaction cannot be voided. Please contact support. _Merchant Message_ The transaction cannot be void. It may have settled, already been voided, or otherwise be illegible for voiding. Please contact your payment gateway for details. **total_credit_exceeds_capture** _Customer Message_ An error occurred while refunding your transaction. Please contact support. _Merchant Message_ The credit exceeds the amount of the original transaction. **authorization_expired** _Customer Message_ An error occurred while processing your transaction. Please contact update your billing information. _Merchant Message_ The purchase authorization expired and can no longer be used to collect payment. Please attempt another transaction. **authorization_already_captured** _Customer Message_ An error occurred while processing your transaction. Please contact support. _Merchant Message_ The purchase amount was already captured. This authorization cannot be used again. **authorization_amount_depleted** _Customer Message_ An error occurred while processing your transaction. Please contact support. _Merchant Message_ The amount of purchases exceeds the original authorized amount. You cannot collect more money using this authorization. **recurly_error** _Customer Message_ An error occurred while processing your transaction. Please contact support. _Merchant Message_ An error occurred while processing the transaction. Please contact Recurly support. **unknown** _Customer Message_ The transaction was declined or failed for an unknown reason. Please try again or contact support. _Merchant Message_ The transaction was declined or failed for an unknown reason. Please try again or contact support. **api_error** _Customer Message_ An error occurred while processing your transaction. Please contact support. _Merchant Message_ The payment gateway returned an error code that usually indicates its API specs have changed. Please contact Recurly support. **duplicate_transaction** _Customer Message_ A similar transaction was recently submitted. Please wait a few minutes and try again. _Merchant Message_ A transaction was recently submitted with the same Invoice Number, or the same card number and amount. The payment gateway refused to process this transaction in order to prevent a duplicate transaction. **recurly_failed_to_get_token** _Customer Message_ An error occurred while initializing the transaction. Please try again. _Merchant Message_ An error occurred while initializing the transaction. Please try again. **recurly_token_not_found** _Customer Message_ An error occurred while processing your transaction. Please contact support. _Merchant Message_ An error occurred while processing the transaction. Please contact Recurly support. Below is an example XML response for the fraud_security_code error: [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<errors>\n <transaction_error>\n <error_code>fraud_security_code</error_code>\n <error_category>fraud</error_category>\n <merchant_message>The payment gateway declined the transaction because the security code (CVV) did not match.</merchant_message>\n <customer_message>The security code you entered does not match. Please update the CVV and try again.</customer_message>\n <gateway_error_code>301</gateway_error_code>\n </transaction_error>\n <error field=\"transaction.account.billing_info.verification_value\" symbol=\"declined_bad\">did not match</error>\n <transaction href=\"https://your-subdomain.recurly.com/v2/transactions/3d1c6aa86e3d447eb0f3b4a6e3e074d9\" type=\"credit_card\">\n <uuid>3d1c6aa86e3d447eb0f3b4a6e3e074d9</uuid>\n <action>purchase</action>\n <amount_in_cents type=\"integer\">4900</amount_in_cents>\n <tax_in_cents type=\"integer\">0</tax_in_cents>\n <currency>USD</currency>\n <status>declined</status>\n <reference nil=\"nil\"></reference>\n <test type=\"boolean\">true</test>\n <voidable type=\"boolean\">false</voidable>\n <refundable type=\"boolean\">false</refundable>\n <transaction_error>\n <error_code>fraud_security_code</error_code>\n <error_category>fraud</error_category>\n <merchant_message>The payment gateway declined the transaction because the security code (CVV) did not match.</merchant_message>\n <customer_message>The security code you entered does not match. Please update the CVV and try again.</customer_message>\n <gateway_error_code>123</gateway_error_code>\n </transaction_error>\n <cvv_result code=\"N\">No Match</cvv_result>\n <avs_result code=\"D\">Street address and postal code match.</avs_result>\n <avs_result_street>Y</avs_result_street>\n <avs_result_postal>Y</avs_result_postal>\n <created_at type=\"datetime\">2011-10-17T17:24:53Z</created_at>\n <details>\n <account>\n <account_code>1</account_code>\n <first_name nil=\"nil\"></first_name>\n <last_name nil=\"nil\"></last_name>\n <company nil=\"nil\"></company>\n <email>verena@example.com</email>\n <billing_info type=\"credit_card\">\n <first_name nil=\"nil\"></first_name>\n <last_name nil=\"nil\"></last_name>\n <address1 nil=\"nil\"></address1>\n <address2 nil=\"nil\"></address2>\n <city nil=\"nil\"></city>\n <state nil=\"nil\"></state>\n <zip nil=\"nil\"></zip>\n <country nil=\"nil\"></country>\n <phone nil=\"nil\"></phone>\n <vat_number nil=\"nil\"></vat_number>\n <card_type>Visa</card_type>\n <year type=\"integer\">2015</year>\n <month type=\"integer\">11</month>\n <first_six>400000</first_six>\n <last_four>0101</last_four>\n </billing_info>\n </account>\n </details>\n </transaction>\n</errors>", "language": "xml" } ] } [/block]