Skip to main content
We’ve categorized potential errors into three distinct areas, and for each, we’ve developed specific contingency plans and operational procedures.

👤 User errors

These are errors that can be self-corrected by recipients

Payment details

  1. Issue with the card number
    • User will see the error message: The card number you have entered is incorrect.
  2. Card is unsupported
    • User will see the error message: The card you have entered is not supported. Please use a Visa or Mastercard debit card.

Returning user

  1. Returning user lands on the first page but has already redeemed the balance.
    • User will see the error message: You have already redeemed the balance.

🖥️ Order errors

These are faults that will require your input to resolve

Insufficient funds

  1. Insufficient balance at order time
    • If your account has insufficient balance you will be unable to create the order for the payment. The API response with a 400 status code, the error message body will contain the type insufficient_funds. Check the order endpoint reference for more information.

User ineligible

  1. Payments cannot be sent to anyone under 18 years old.
    • User will see the error message: We cannot send funds to anyone under the age of 18.
  2. Payments cannot be sent to anyone who appears on a sanctions list.
    • User will see the error message: There’s been an unexpected issue, please contact the issuer of this link.
    • Runa will send you an email to inform you that this has happened, with our reasoning attached.
  3. Card issue
    • Payment sent to a user who doesn’t have an eligible debit card with Visa/Mastercard.
    • User will see the error message: We can only send funds to a Visa or Mastercard debit card.

⚙️ Processing errors

In-journey errors

  1. Authentication error: Recipient hasn’t received email with code
    • User will need to contact Runa for us to investigate what might have gone wrong with authentication.
  2. Authentication error: Code that recipient has received not working.
    • User will need to contact Runa for us to investigate what might have gone wrong with authentication.
  3. Card issue: The recipient’s saved card has expired.
    • User will see the error message: “Card expired” and will be able to contact Runa for us to delete their original card so they can add a new one.
    • Note: from early April recipients will be able to self-serve editing their existing cards
  4. Card issue: The recipient’s saved card has expired.
    • User will see the error message: “Card expired” and will be able to contact Runa for us to delete their original card so they can add a new one.
    • Note: from early April recipients will be able to self-serve editing their existing cards
  5. Fraud Suspected
    • If fraud is suspected, we will hold on sending out the payout until we have established that the payment isn’t fraudulent. During this time, we will either ask the end recipient to share additional information, or we will have to cancel the payment and inform you that it’s been cancelled with a reason as to why.
  6. Recipient bank has rejected payment
    • The most common payment issue we are likely to experience is the recipient’s bank rejecting the payment we send them. If this happens we will send the recipient an email to say their bank has rejected the payment, with advice to either resolve this with their bank or to contact us to manually delete their card so they can try a different card.

All other issues

Your point of contact for any other issues: support@runa.io