Payball

Payball is an app. Install it from Apps, then open it with Open app: it opens inside your admin, signed in to your store as you. Only the store’s owner opens it and changes its keys, since they say where your customers' card payments are paid; open it again from Apps if it has been open for more than 15 minutes when you save. The app is free; Payball charges its own fees under your contract with it. Its page is in English, like Payball’s own cabinet.

Once installed, Payball shows in Settings › Payments among the payment apps, where you switch it on and choose Test or Live (see Payments). It takes payments in euros, in whole cents: Payball is not offered for an order in another currency, and a payment it cannot charge exactly is refused, so the customer chooses another way to pay. Save your keys for that mode and press Test connection first: without them, every payment fails.

Your keys

The app has two cards, Test and Live. Each needs the payment method GUID and the private key of that Payball project; the private key is kept encrypted and never shown again (leave it empty to keep it). Test and live need different payment method GUIDs. Leave Payball addresses empty: Payball’s own are used. Fill them in only if Payball gives you others.

Test connection saves the keys you typed and makes an unpaid checkout of 10.00 EUR at Payball, then reads it back: nothing is charged. Keys you change later apply to new payments; a payment already started finishes with the keys it was started with. If you make a new private key for the same Payball project, open payments switch to it once Payball refuses the old one.

The page shows the callback address: save it in each Payball project, test and live. Payball calls it when a payment changes, so orders are paid sooner.

How a payment goes

At checkout the customer is sent to Payball’s card page, with their name and address filled in for Payball in Latin letters. Payball’s page is in English; the line about the payment names the order in the customer’s language where it has a Latin spelling (“Bestellung #1042”), and in English otherwise (“Order #1042”). Back from it, they see their order. The app never trusts the way back or Payball’s callback alone: it asks Payball how the payment stands, and tells your store.

• Paid: the order is paid and confirmed. If Payball took another amount than the order’s, the order is not marked paid and the alerts bell tells you (see Payments).
• Declined: the customer sees that the payment did not go through and can pay again from the order page; the order’s Payment tries says why (declined by the bank, 3-D Secure failed, and so on). Each try has its own reference at Payball: an S and your store’s tag, the order number, -R1, -R2 for later tries, and eight characters of its own (for example Sk7q2m9-1042-R1-p4ja7nbe); search Payball’s cabinet by it.
• Still being checked: the order waits. Once Payball says it is taking a card, the order is not let go for a day, unless Payball says the payment failed. Payball sometimes confirms a payment many minutes or even hours later; the app reads every open payment again every few minutes for two hours, then hourly for a day, so a late confirmation still pays its order, even one already cancelled for running out (the bell then tells you to refund it).

When Payball cannot be reached, nothing is decided: the order is never let go because Payball did not answer.

Latest payments on the app’s page lists the payments it made, with their reference at Payball and how they stand.

Refunds

Payball refunds a whole payment only. Refund the whole card payment in Storeloom (the order’s total, less any gift card that paid part of it) and the app sends the refund to Payball, once, however often it is asked. A refund of part of a payment cannot go through Payball: refund that part in Payball’s cabinet, then refund it in Storeloom. Storeloom says Payball cannot refund part of a payment and shows I sent the money back with the provider myself: tick it and save. If Payball took another amount than the order’s and you counted it as paid, the whole payment is what Payball took: only a refund of exactly that amount goes through Payball (the message says the amount), since Payball sends back all of it.

When Payball takes the refund but gives no clear answer, or does not answer at all, the app never sends it again. It lists it under Refunds to confirm: check it in Payball’s cabinet, then press Refunded or Not refunded, and your store is told. If Payball answered that the refund is under way, wait while its cabinet shows it processing, and press Not refunded only if it shows no refund or a failed one. If the app says your store has no record of the refund yet, your answer is kept, shown beside the refund, and passed on as soon as your store has it (for an hour; if it is still listed after that, press it again). If you have not refunded the order in Storeloom, do it there: after Refunded it takes your answer and Payball is not asked again; after Not refunded the refund is asked of Payball again (unless Payball has said it refunded it or is refunding it). If Payball’s own answer comes in late, after the app stopped waiting for it, the app shows it beside the refund and never acts on it by itself: check the refund in the cabinet again and answer. An answer you gave before it that says otherwise is not passed on to your store until you answer again, and a refund Payball says it refunded or is refunding is never asked of Payball again, whatever you answer after. If Payball answers while you have the page open, your next press asks you to look again. If your store already has the refund the other way (refunded though Payball refused it, or not refunded though Payball refunded it or is refunding it), it stays listed for 30 days with what to do. For a refund Payball made, record it in your Storeloom admin without sending money again, if you have not already: press I sent it back another way beside it under Payment tries, or, if the order has no such refund there, refund the order: Storeloom says Payball cannot refund it and shows I sent the money back with the provider myself; tick it and save. For a refund Payball says is under way, wait while its cabinet shows it processing, and refund there only if it shows no refund or a failed one, so the customer is not refunded twice. A new refund of a payment refunded already is not sent to Payball: Storeloom says so. An answer about a refund you asked again in Storeloom since is not shown: Payball’s answer to the new refund decides.

Remove the app

Remove in Apps takes Payball off your checkout at once. It cannot be removed while a payment through it is still open, a declined order may still be paid again, or a refund is waiting. Two days later the app deletes everything it kept for your store.

What the app keeps

The app keeps your store’s address, name, Payball keys and its access to your store (the private keys and the access encrypted; private keys you replace stay, encrypted, with the payments started with them, until everything is deleted after the app is removed); for each payment its order number, amount, currency, its reference at Payball and how it stands there, with Payball’s reason when a payment is declined; and for each refund its amount, Payball’s answer and yours. It keeps the link back to the customer’s order page until the payment is settled, your store told and two days have passed, and 14 days at most. It passes the customer’s name, email, phone and billing address to Payball with the payment, so they type only their card, and keeps none of them (a decline message from Payball, kept short, could repeat a name); it never sees a card. Everything kept for your store is deleted two days after the app is removed. The App Shop links to the app’s privacy page, which says the same.