# Kif tqabbad il-pagamenti b'Revolut (inkluż sandbox u kards tat-test)

Il-mistednin iħallsu t-taxxa tat-turisti, id-depożitu ta' sigurtà u l-extras permezz tal-**kont merchant tiegħek stess ta' Revolut Business**. Il-flus imorru dritt għandek; aħna qatt ma nżommuhom. Għandek bżonn kont Revolut Business bil-prodott **Merchant** (aċċettazzjoni tal-kards) attivat.

Nirrakkomandaw bil-qawwa li tqabbad is-**sandbox** l-ewwel. Is-sandbox hija kopja separata ta' Revolut Business għat-testijiet: ma jiċċaqilqu l-ebda flus veri, u tista' tipprova kull riżultat bil-kards tat-test.

## 1. Oħloq kont sandbox ta' Revolut

1. Mur fuq `https://sandbox-business.revolut.com/signup` u rreġistra.
2. Jekk m'intix ċert liema tip legali ta' negozju tagħżel, agħżel **Public Limited Company** (il-kontijiet ta' freelancer mhumiex appoġġjati fis-sandbox).
3. Meta tintalab tivverifika l-email, ikklikkja **Skip email verification**. Għall-kodiċi ta' konferma kklikkja **Autofill code**. L-approvazzjonijiet fis-sandbox huma awtomatiċi.

> **Importanti:** Il-keys tas-sandbox jaħdmu biss f'sandbox mode u l-keys live biss f'live mode. Ma tistax tħallathom.

## 2. Ikkopja l-API keys tas-sandbox

1. Idħol minn `https://sandbox-business.revolut.com/signin`.
2. Iftaħ **Merchant**, ikklikkja l-menu **⋯** u agħżel **Merchant API** (link dirett: `https://sandbox-business.revolut.com/settings/apis?tab=merchant-api`).
3. Ikklikkja **Generate** ħdejn is-**Secret key** jekk għad m'hemmx waħda, imbagħad ikkopjaha (tibda b'`sk_`).
4. Ikkopja wkoll il-**Public key** (tibda b'`pk_`). Hija meħtieġa għall-buttuni ta' Apple Pay u Google Pay.

## 3. Daħħal il-keys fid-dashboard tiegħek

1. Iftaħ **Settings → Payments**.
2. Waħħal is-**Secret API key** u l-**Public API key**.
3. Immarka **Sandbox mode (test payments with Revolut test cards)**.
4. Ikklikkja **Save**, imbagħad **Test connection**. Għandek tara *Connected to Revolut (sandbox)*.
5. Ikklikkja **Register webhook**. Issa Revolut jgħarraf lill-portal tiegħek minnufih meta pagament jirnexxi, ifalli, jew meta hold ta' depożitu jinġabar jew jiġi rilaxxat. L-istatus jinbidel għal *Registered*.

Is-secret key tinħażen kriptata. Meta terġa' lura aktar tard tintwera moħbija — ħalliha kif inhi biex iżżomm il-key issalvata.

![Settings → Payments](/site/img/docs/d-settings-payments.webp "Settings → Payments")

## 4. Ittestja bil-kards tat-test ta' Revolut

Oħloq booking tat-test bl-indirizz tal-email tiegħek, iftaħ il-link tal-mistieden u ħallas. Fis-sandbox uża kwalunkwe **data ta' skadenza fil-futur** u **kwalunkwe CVV ta' 3 ċifri**.

| Numru tal-kard | Brand | Riżultat |
|---|---|---|
| `4929 4205 7359 5709` | Visa | Il-ħlas jirnexxi |
| `5281 4388 0180 4148` | Mastercard | Il-ħlas jirnexxi |
| `4929 5736 3812 5985` | — | Rifjutat: fondi insuffiċjenti |
| `4532 3367 4387 4205` | — | Rifjutat: kard skaduta |
| `2720 9988 3777 9594` | — | Rifjutat: do not honour (emittent) |
| `4242 4242 4242 4242` | — | L-isfida 3-D Secure tfalli (biss għal ammonti ta' €30.00 jew aktar) |
| `5215 6741 1512 7070` | — | Ifalli: l-emittent jeħtieġ verifika addizzjonali |
| `2223 0000 1047 9399` | — | Jibqa' fi proċessar (l-awtorizzazzjoni bdiet) |

Ammonti taħt €30.00 (jew £25.00) huma eżentati mit-3-D Secure fis-sandbox u jirnexxu mingħajr sfida. Biex tara falliment tat-3-D Secure, uża booking tat-test b'depożitu ta' mill-inqas €30.

Iċċekkja fid-dashboard li:

- it-taxxa tat-turisti turi **Paid** u d-depożitu **Held** (pre-awtorizzazzjoni) jew **Paid** (charge mode),
- il-portal tal-mistednin jinfetaħ ladarba l-passi kollha jkunu lesti,
- tasal email bl-irċevuta,
- **Release deposit** fil-booking jirrifondi jew jirrilaxxa l-hold.

### Ittestja minn Settings → Payments

M'għandekx bżonn booking biex tittestja l-katina kollha. Taħt **Settings → Payments → Test payments** daħħal ammont (1–50) u agħfas:

- **Test charge & refund** — ħallas l-ordni tat-test fit-tab il-ġdida, imbagħad agħfas **Refund**. Hekk jaħdmu t-taxxi, l-extras u d-depożiti f'mod *charge & refund*.
- **Test deposit hold & release** — ħallas l-ordni tat-test (l-ammont jinżamm biss fuq il-kard), imbagħad agħfas **Release hold**, jew **Keep half, release rest** u wara **Refund the kept part**. Dan huwa l-mod tad-depożitu *hold*.

Kull test jelenka x'wieġeb Revolut f'kull pass u jimmarka **Webhook received** meta n-notifika ffirmata ta' Revolut tkun waslet għand Guestbud — dan huwa dak li jikkonferma l-pagamenti tal-mistednin waħdu. Jekk il-webhook qatt ma jasal, agħfas **Register webhook**. F'live mode it-test juża kard vera u jiġi rifużjonat minnufih; Revolut jista' jżomm it-tariffa tiegħu.

## 5. Mur live

1. Fil-kont live tiegħek ta' Revolut Business (`https://business.revolut.com`) iftaħ **Merchant → ⋯ → Merchant API** u kkopja s-secret key u l-public key live.
2. F'**Settings → Payments** waħħalhom, neħħi l-marka minn **Sandbox mode**, **Save** u **Test connection** (*live*).
3. Ikklikkja **Register webhook** mill-ġdid — il-kont live jeħtieġ il-webhook tiegħu.
4. Agħmel ħlas wieħed żgħir reali bil-kard tiegħek u rrifondih f'Revolut.

## Metodi ta' ħlas

Taħt **Payment methods** agħżel x'jiġi offrut lill-mistednin:

- **Card payment** — il-checkout hosted ta' Revolut (il-kards ewlenin kollha, 3-D Secure).
- **Apple Pay** u **Google Pay** — ara [Apple Pay u Google Pay](/docs/apple-pay-google-pay).
- **Manual payment** — mitfi b'mod awtomatiku. Ixgħlu biex il-mistednin ikunu jistgħu jagħżlu flus kontanti jew trasferiment bankarju; int tikkonfermah b'**Mark as paid** fil-booking. Żid struzzjonijiet bħall-IBAN tiegħek.

![X'jara l-mistieden waqt il-ħlas](/site/img/docs/m-payment-sheet.webp "X'jara l-mistieden waqt il-ħlas")

## Depożiti: hold jew ċarġ

Depożitu jista' jkun **pre-awtorizzazzjoni fuq il-kard** (il-flus jiġu riżervati iżda ma jittiħdux; jiġu rilaxxati wara l-check-out) jew **ċarġ** li tirrifondi aktar tard. Il-holds jiskadu wara 7 ijiem b'mod awtomatiku; immarka **Deposits as card pre-authorisation for up to 30 days** jekk il-kont Revolut tiegħek għandu extended authorisations. Dettalji: [Depożiti u waivers](/docs/deposits-and-waivers).

## Soluzzjoni tal-problemi

### Test connection jgħid li Revolut irrifjuta l-key (401)?

Probabbilment waħħalt key live f'sandbox mode jew bil-maqlub, jew ikkopjajt il-public key fil-qasam tas-secret. Is-secret key tibda b'`sk_`.

### Il-mistieden ħallas iżda l-booking għadu jgħid waiting for bank?

Il-webhook nieqes jew qed jipponta lejn indirizz qadim. Ikklikkja **Register webhook** mill-ġdid. Il-portal jerġa' jiċċekkja wkoll il-pagamenti miftuħa kull meta l-mistieden jiftaħ il-paġna.

### Nista' nuża kont Revolut wieħed għal diversi kumpaniji?

Kull tenant iqabbad il-kont merchant tiegħu. Jekk timmaniġġja proprjetajiet għal diversi sidien taħt kumpanija waħda, kont wieħed huwa biżżejjed.

### Il-portal tal-mistednin jaħżen id-dettalji tal-kard?

Le. Id-dettalji tal-kard jiddaħħlu fil-paġni ta' Revolut jew fil-payment sheet ta' Revolut u qatt ma jaslu fis-servers tagħna.

## Mod tad-depożitu, perjodu tar-rilaxx u sigurtà tas-sandbox

![Mod tad-depożitu, perjodu tar-rilaxx u l-email tat-test tas-sandbox](/site/img/docs/d-payments-deposit.webp "Mod tad-depożitu, perjodu tar-rilaxx u l-email tat-test tas-sandbox")

Taħt **Settings → Payments → Revolut Merchant**:

- **Deposit mode** — *Charge & refund* (id-default): id-depożitu jittieħed minn qabel u jiġi rifużjonat wara l-check-out, kollu jew parti minnu — sigur għal soġġorn ta' kwalunkwe tul. *Hold (pre-authorisation)*: l-ammont jiġi biss imblukkat fuq il-kard u rilaxxat awtomatikament, iżda hold idum l-aktar 7 ijiem (30 b'pre-awtorizzazzjoni), għalhekk huwa adattat biss għal soġġorni qosra. Kull proprjetà ssegwi dan id-default sakemm il-**Guide editor → Payments → How it is taken** tagħha ma jgħidx mod ieħor; immarka **Use this deposit mode for all properties** biex taqleb lil kollha għad-default.
- **Release the hold this many days after check-out** (default 2) — iż-żmien li għandek biex tispezzjona l-proprjetà u żżomm flus għall-ħsara qabel ma Revolut jirrilaxxa l-hold waħdu. 0 = rilaxx mal-check-out.
- **Sandbox test email** — sakemm **Sandbox mode** ikun mixgħul, il-mistednin reali qatt ma jiġu kkuntattjati: l-emails lill-mistednin imorru f'dan l-indirizz (vojt = l-email tal-host) u l-messaġġi permezz tal-kanal tal-booking jinżammu. Itfi s-sandbox biss meta tkun lest biex tieħu pagamenti reali b'key live.