# Pay In troubleshooting

> Resolve common Pay In issues with our troubleshooting guide. Find solutions for transaction failures, funding delays, declined payments, and API integration challenges with step-by-step diagnostic help

This guide covers common issues and questions related to Pay In features. If you have a question that isn't covered here, please reach out to Payabli Support.

<Note>
  We *strongly* suggest you use the AI chat to find answers instead of browsing through these docs. The chat has access to the most up-to-date information and can provide you with the best answers.
</Note>

## Payment method management

<AccordionGroup>
  <Accordion title="Why doesn't a payment method doesn't save to the customer profile?">
    When saving a payment method with an embedded component or the API, you may get a success response that returns a method without it saving to the customer's profile. This typically happens because the API or embedded component was configured to create a temporary token.

    To fix this, configure the request or component to return permanent tokens:

    * **For tokenization API requests**: Set the `temporary` query parameter to `false`. See [this guide](/guides/platform-developer-tokenization-save-method#query-parameters) for more.

    * **For embedded components**: In the component configuration, set `temporaryToken` to `false`. See the configuration references for [EmbeddedMethod UI](/guides/pay-in-components-embeddedmethod-ui#configuration-reference) and [PayMethod UI](/guides/pay-in-components-paymethod-ui#configuration-reference) for more.
  </Accordion>

  <Accordion title="How long does a temporary token for a payment method last?">
    When configuring the PayMethod UI embedded component, or saving a payment method via the API, setting `temporary` or `temporaryToken` to `true` creates a temporary, one-time-use token for the payment method. The token expires in 12 hours.
  </Accordion>

  <Accordion title="Which credit card brands does Payabli support?">
    Payabli supports the following credit card brands:

    * Visa
    * Mastercard
    * American Express
    * Discover
    * JCB
    * Diners Club

    If you have questions about specific card types or brands, reach out to Payabli Support.
  </Accordion>
</AccordionGroup>

## Troubleshooting payment issues

<AccordionGroup>
  <Accordion title="Why am I getting an expired card error when the expiration date is valid?">
    An expired card decline can occur in two scenarios:

    1. The card issuer has determined the card is expired. Sometimes a card that has been reported lost or stolen is marked by the bank as expired. In this case, the customer must provide a new card number.
    2. When using a tokenized card number, if the original card associated with the token has expired, even if you provide a valid expiration date in the request.

    If you receive this error when using a tokenized card, you need a new card number from the customer to create a new token. For more details on card response codes, see [Payment Response Codes and Errors](/guides/platform-return-codes-and-errors-reference#card-response-codes).
  </Accordion>

  <Accordion title="What does consumer verification negative mean?">
    When an ACH payment is declined and you get the "consumer verification negative" message, it's because either:

    * The customer entered their account information incorrectly and caused an earlier ACH return. Have the customer check their account information and try again. If the issue persists, try a different payment method.
    * The account number entered is flagged as a risk because of earlier ACH returns, and the transaction has been declined. In this case, the customer must use a different payment method.
  </Accordion>

  <Accordion title="Why isn't contactless payment working on my PAX terminal?">
    The PAX terminal's contactless payment feature requires specific card placement for successful transactions:

    1. Hold the card at the end of the device where the contactless logo is located (not on the face of the device).
    2. Keep the card steady and held in place until you hear a beep.

    If the contactless payment continues to decline, we recommend completing the transaction by either inserting the chip or swiping the card instead. The PAX terminal's contactless reader can be sensitive and may not always successfully read contactless cards even when properly positioned. This is a known hardware limitation. The PAX doesn't support contactless payments with Diners Club cards, they must be inserted.
  </Accordion>
</AccordionGroup>

## Refunds and transaction costs

<AccordionGroup>
  <Accordion title="Can I refund a fee?">
    Payabli supports [pass-through fees](/guides/pay-in-fees-passthrough-overview). Because pass-through fees cover the standard processing cost for the original transaction, they aren't returned when a merchant issues a full or partial refund to customers. If a transaction with a pass-through fee is voided before settlement, the fee is canceled too.

    Letting customers know at time of transaction that the fee is non-refundable helps minimize disputes.
  </Accordion>

  <Accordion title="Do refunds and voids incur transaction costs?">
    When you cancel a transaction by voiding it before the batch closes or refunding it, you may incur processing costs for the cancellation.

    ### Voids

    For voids, there are authorization costs for the original transaction, but there is no extra cost to make a void. Voids cancel the transaction before it's processed, so a voided transaction doesn't incur interchange costs.

    ### Refunds

    You can only refund a transaction after it's been processed, so the original transaction incurs authorization costs and interchange costs. A refund is a second transaction, so there is an additional authorization cost for the refund itself. The original transaction's costs aren't refunded to the merchant.

    If you have questions about your interchange and authorization costs, reach out to support.
  </Accordion>
</AccordionGroup>

## ACH payment handling

<AccordionGroup>
  <Accordion title="What is a Check Truncation Entry Return for ACH payments?">
    A Check Truncation Entry Return (return code R11) occurs when an electronically processed check payment is returned unpaid. This can happen due to various reasons such as insufficient funds, invalid account numbers, or suspected fraudulent activity. When this occurs, the electronic image of the check couldn't be processed successfully through the ACH network.

    For more information about ACH disputes and returns, see [ACH disputes](/guides/pay-ops-disputes-chargebacks-returns-overview#ach-disputes-overview).
  </Accordion>

  <Accordion title="How can I prevent ACH returns due to business bank authorization issues?">
    Some banks require pre-authorization for ACH transactions. To ensure smooth processing and prevent ACH returns due to authorization issues, we recommend the following steps:

    1. Recommend that your customer authorize ACH transactions with their bank in advance.
    2. Provide the customer with the ACH ID and descriptor: 1841393599 / WFMSPROPAY to give to their bank for allowlisting.

    Pre-authorization is not always required, it depends on the customer's bank. For more information about different types of ACH returns, see the [ACH Return Codes Reference](/guides/platform-ach-return-codes-reference).
  </Accordion>

  <Accordion title="What happens when a payor initiates a stop payment on an ACH transaction?">
    When a payor initiates a stop payment on an ACH transaction, the funds are never collected from their account. This is reflected in Payabli's system through the following process:

    1. The transaction is initially recorded in a batch (for example, 'batch\_combined')
    2. When the stop payment is processed, it appears as a return in Payabli.
    3. The return is then reconciled through a corresponding return batch (for example, 'batch\_combined\_return')

    To verify a stop payment:

    * Check the transaction status for the return indication
    * Review the batch reconciliation records for both the initial transaction and return entries

    For more information about ACH returns and disputes, see [Payment Disputes](/guides/pay-ops-disputes-chargebacks-returns-overview#ach-disputes).
  </Accordion>
</AccordionGroup>

## Related resources

See these related resources to help you get the most out of Payabli.

<AccordionGroup>
  <Accordion title="References">
    * **[ACH return codes reference](/guides/platform-ach-return-codes-reference)** - Understand how to handle different types of ACH returns
    * **[Pay In schemas](/guides/pay-in-schemas-overview)** - Learn about Pay In (money in) transaction schemas
    * **[Pay In statuses](/guides/pay-in-status-reference)** - Learn about Pay In (money in) statuses
    * **[Payment response codes and errors](/guides/platform-return-codes-and-errors-reference)** - Learn about payment response codes for different payment methods
  </Accordion>
</AccordionGroup>