Payment integration
Connect your Stripe, Easypay or Ifthenpay account to your Prood store.
Your store takes payments through your own account with a payment provider. Payouts go straight from the provider to you, and Prood adds nothing on top of their fees.
Choose a provider
| Provider | Region | What customers can pay with |
|---|---|---|
| Stripe | International | Cards, plus Apple Pay and Google Pay where you've enabled them |
| Easypay | Portugal | Multibanco, MB WAY and cards |
| Ifthenpay | Portugal | Multibanco, MB WAY and cards |
Easypay and Ifthenpay put Multibanco, MB WAY and cards in one checkout. Stripe covers cards and wallets. Each store's checkout runs on one provider, and Stripe comes first if it's connected.
For Apple Pay and Google Pay, enable them in Stripe and register checkout.prood.com there.
Connect it
Go to Integrations, under Connections in the dashboard, and choose your provider. Each store connects its own account, so credentials are never shared between stores. They're stored separately and encrypted at rest with AES-256-GCM.
Stripe
Get your keys from the Stripe dashboard, under Developers.
| Field | Looks like |
|---|---|
| Publishable key | pk_live_... or pk_test_... |
| Secret key | sk_live_... or sk_test_... |
| Signing secret | whsec_... |
Add the webhook first, because Stripe gives you the signing secret when you do. Prood tests the keys when you save. Use two test keys or two live keys, not one of each.
To test, use Stripe's test keys and card 4242 4242 4242 4242, with any future expiry date and CVC.
Easypay
Find these in your Easypay account.
| Field | Notes |
|---|---|
| Account ID | Required |
| API key | Required |
| Easypay address | Optional, under Advanced. Leave it empty for live payments, or use https://api.test.easypay.pt to test |
Prood tests the keys when you save.
Ifthenpay
Enable your payment methods with Ifthenpay first, then enter each key.
| Field | Notes |
|---|---|
| Anti-phishing key | Required |
| Multibanco key | Required |
| MB WAY key | Optional. Adds MB WAY to checkout |
| Credit card key | Optional. Adds cards to checkout |
Ifthenpay can't test keys, so place a small order to check them.
Add the webhook
Orders are only marked as paid when your provider calls your store's webhook URL. See Webhook setup.
Refunds
| Payment | What happens |
|---|---|
| Stripe | Refund order in the dashboard sends the money back |
| Easypay, MB WAY and cards | Refund order in the dashboard sends the money back |
| Easypay, Multibanco | Refund in your Easypay account, then record it in the dashboard |
| Ifthenpay | Refund in your Ifthenpay account, then record it in the dashboard |
Change provider
Connect the new provider in Integrations and add its webhook. To move off Stripe, switch off Turned on on its page: while Stripe is connected and on, checkout uses Stripe. Your old provider still reports on payments it took before you turned it off.
Troubleshooting
| Issue | What to check |
|---|---|
| "It didn't accept that key" | Copy the key again from your provider's account |
| "These keys come from different modes" | Use two test keys or two live keys |
| Orders stay Unpaid after payment | The webhook URL in your provider's account, and for Stripe the signing secret and events |
| A Multibanco reference doesn't show | Check the keys for the payment method you chose |
| "This store has no payment provider connected yet" | Connect one under Integrations and make sure it's turned on |