Pagamenti u taxxi · għal Hosts

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

Qabbad il-kont merchant ta' Revolut Business: keys tas-sandbox, kards tat-test, webhook, metodi ta' ħlas, depożiti bħala hold jew ċarġ, u mur live.

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.

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.

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.

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.
• 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.

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.

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 #

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.