Support
Read answers to common questions and learn how to troubleshoot problems
Use the search for better answers
Our search tool can help you find answers to your questions. If you can’t find what you’re looking for, contact support.
Pay In
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 tofalse
. See this guide for more. -
For embedded components: In the component configuration, set
temporaryToken
tofalse
. See the configuration references for EmbeddedMethod UI and PayMethod UI for more.
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.
Payabli supports pass-through fees. 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.
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.
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.
An expired card decline can occur in two scenarios:
- 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.
- 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.
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.
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:
- Recommend that your customer authorize ACH transactions with their bank in advance.
- 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.
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:
- The transaction is initially recorded in a batch (for example, ‘batch_combined’)
- When the stop payment is processed, it appears as a return in Payabli.
- 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.
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.
Pay Out
If a vendor doesn’t process their vCard payment within a reasonable period, Payabli’s system may automatically reissue the payment as a check. In that case, the payment status shows as IN TRANSIT when the check has been issued and mailed, indicating that it has been sent but not yet deposited by the vendor. You can track the status of these payments in Money Out Statuses.
If you need to verify the delivery status of a check payment, contact Payabli support with the check number and date issued.
If you’re using managed payables and a vendor needs to update their bank account information for receiving ACH payment, reach out to Payabli support. The Support team helps coordinate authorizing the bank change with the vendor.
For security purposes, the vendor must complete a new ACH/Direct Deposit enrollment form.
If the vendor has relationships with multiple paypoints or organizations, include the vendor ID for all associated paypoints. This makes sure that the vendor’s bank account information is updated across all relevant paypoints and organizations.
You don’t need to create a new vendor record to update a bank account.
Existing vendor names can’t be modified in Payabli. To change a vendor’s name:
- Create a new vendor record with the business name and details using the Vendor API or vendor management in the UI.
- Submit new payments under the business vendor record.
- The vendor will go through the payment enablement process for the new business record.
The original vendor record remains in the system, but is inactive. Each vendor record must have its own banking information and vendor ID.
When a vendor indicates that a payment is not needed (for example, if an invoice was already paid), payables agents may initiate a cancellation without requiring a client request. This process works as follows:
- Payables agents verify with the vendor that the payment is not needed.
- The agent cancels the payment and processes a refund.
- A notification is automatically sent to let you know about the cancellation and the system updates to reflect cancelled status.
Although merchants can initiate cancellations themselves, payables agents are authorized to process cancellations proactively to avoid holding funds for unnecessary payments. This helps prevent duplicate payments and ensures efficient fund management.
Pay Ops
Sometimes, you may notice that a paypoint’s status is listed as “Inactive”, while the corresponding boarding application status is “Activated”. This typically happens when the paypoint is still being configured.
When a boarding application is approved and converted to a paypoint, there are several steps that the Payabli team takes behind-the-scenes to get the paypoint set up and ready to accept payments. Because of this configuration step, there can be a delay between the “Activated” boarding status and the paypoint’s status being updated to “Active”.
When the paypoint is ready to process transactions, the boarding status is “Activated” and the paypoint status is “Active”. After the paypoint has successfully processed a transaction, the boarding status is updated to “Live”.
If a paypoint was previously active, an Inactive status means that it’s no longer able to take payments but can still receive chargebacks and returns.
See Paypoint statuses and boarding statuses for more information.
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.
A Payabli Service Payment charge on your statement can represent various transaction types, including chargebacks. When you see such a charge, it could be due to:
- A chargeback from a customer transaction
- Amounts owed back, due to ACH returns or refunds
- Associated processing fees
To identify the specific nature of the charge, you can:
- Note the exact amount and date of the charge.
- Contact Payabli support with the transaction details.
- Request the batch information if applicable.
For more information about how chargebacks work and their impact on your account, see the Payment Disputes guide.
At this time, we can’t modify the settlement deposit descriptors shown on your bank statement. Your settlement deposit descriptor shows up on your bank statement as “PAYABLI DEPOSIT”, but may also include alphanumeric characters before and after that text. For example, “PP* PAYABLI DEPOSIT”, “PAY-IN PAYABLI DEPOSIT”, “PAYABLI DEPOSIT- 987654321”.
However, you can change the descriptor that shows up on customer cardholder statements. To make this change, contact Payabli Support. The text must indicate the name or DBA name of the business. If your business legal name changes, contact Payabli Support.”
If you notice discrepancies between a merchant’s bank statements and Payabli’s batch reports, you can take the following steps to investigate and resolve:
- Review the specific batch, including all transactions associated with the batch.
- Gather supporting documentation, like merchant bank statements and Payabli transaction and batch reports.
- Contact Payabli Support with these details for investigation.
Payabli’s support team will review the transactions and verify all charges and refunds, identify any missing or incorrect transactions, resolve any reconciliation errors if confirmed.
General FAQ and troubleshooting
For security reasons, you may be blocked when you try to access Payabli from some countries outside of the U.S. You will get an error that says “Connection denied by Geolocation Setting”. Use a VPN to connect. Contact Payabli support if you need access to a VPN solution.
Was this page helpful?