Prasyarat
Untuk menyelesaikan panduan ini, Anda harus telah menyelesaikan hal-hal berikut:
- Memahami Kebijakan Pembayaran kami.
- Menyelesaikan bagian Export Feeds dari Integrasi E2E Anda.
Berikut adalah jenis pembayaran yang didukung untuk add-on ini:
- Pembayaran di muka
- Tarif Ketidakhadiran / Biaya Pembatalan
- Deposit
- Kartu Kredit Diperlukan
Semua kasus penggunaan untuk pembayaran merupakan ekstensi untuk kasus penggunaan tanpa pembayaran/bayar saat kedatangan (yang tidak memerlukan konfigurasi pembayaran) sehingga tutorial ini akan dimulai dengan menjelaskan konfigurasi tersebut dan memperlakukan konfigurasi lain sebagai ekstensi.
Pembayaran di muka
Konfigurasi ini digunakan untuk menentukan bahwa jumlah layanan harus dibayar penuh pada saat pemesanan. Pembayaran di muka ditentukan pada tingkat ketersediaan melalui kolom payment pada feed Avaibility.
{
"availability": [{
"merchant_id": "dining-A",
"service_id": "reservation",
"start_sec": 1535853600,
"duration_sec": 2700,
"spots_total": 2,
"spots_open": 2,
"resources": {
"room_id": "A-dining-room",
"room_name": "Wine Tasting Room",
"party_size": 2,
"prepayment": {
"price_info": {
"price": {
"price_micros": 200000000,
"currency_code": "USD",
},
"price_type": "PER_PERSON"
}
}
}
}]
}
Denda Ketidakhadiran
Biaya ketidakhadiran dapat ditagihkan kepada pengguna jika mereka tidak menghadiri reservasi, atau jika mereka membatalkan setelah periode pembatalan. Jika tidak ada periode pembatalan yang ditentukan, waktu mulai slot akan ditetapkan secara default.
Untuk menentukan denda ketidakhadiran, dalam feed layanan, Anda harus menyertakan kolom no_show_fee seperti yang ditunjukkan pada contoh berikut:
{
"merchant_id": "merchant-1",
"service_id": "service-2-b",
"name": "Reservation",
"description": "A dining reservation",
"price": {
"price_micros": 200000000,
"currency_code": "USD"
},
"scheduling_rules": {
"min_advance_online_canceling": 14400,
},
"no_show_fee": {
"fee": {
"price_micros": 25000000,
"currency_code": "USD"
},
"fee_type": "FIXED_RATE_DEFAULT"
}
}
Dalam contoh ini, partner atau penjual diizinkan untuk mengenakan biaya tetap sebesar $25 sebagaimana ditentukan dalam kolom no_show_fee.fee.price_micros jika pemegang janji temu tidak menghadiri janji temu. Biaya ini juga dapat dikenakan
jika pengguna membatalkan dalam waktu 4 jam (14.400 detik) sebelum janji temu,
seperti yang ditentukan dalam kolom scheduling_rules.min_advance_online_canceling.
Untuk mengetahui cara menentukan biaya acara di feed ketersediaan, lihat Mengganti Harga pada Tingkat Ketersediaan.
Biaya ketidakhadiran dapat dikonfigurasi secara opsional agar dikenai biaya per orang untuk reservasi. Dalam hal ini, no_show_fee.fee.fee_type dapat ditetapkan ke
PER_PERSON.
Deposit
Setoran digunakan untuk mengumpulkan tagihan awal sebagai persyaratan pemesanan. Setoran dapat ditagih pada saat pemesanan atau di lain waktu. Anda mungkin perlu menentukan pada jangka waktu mana setoran dapat dikembalikan serta kapan pemesanan dapat dibatalkan secara online.
Untuk menentukan setoran, di feed layanan, Anda harus menyertakan kolom deposit
seperti yang ditunjukkan pada contoh berikut:
{
"merchant_id": "merchant-1",
"service_id": "service-2-b",
"name": "Reservation",
"description": "A dining reservation",
"price": {
"price_micros": 200000000,
"currency_code": "USD"
},
"scheduling_rules": {
"min_advance_online_canceling": 86400,
},
"deposit": {
"deposit": {
"price_micros": 25000000,
"currency_code": "USD",
"min_advance_cancellation_sec": 14400,
},
"deposit_type": "FIXED_RATE_DEFAULT"
}
}
Dalam contoh ini, min_advance_online_canceling
menentukan periode pembatalan dan
deposit.min_advance_cancellation_sec
menentukan kapan setoran dapat dikembalikan dananya. Perhatikan bahwa dalam contoh, setoran dapat
menentukan waktu pembatalan secara terpisah dari persyaratan pengembalian dana. Dalam hal ini, pengguna akan dapat membatalkan layanan secara online hingga 24 jam sebelumnya (86.400
detik). Hal ini memastikan bahwa penjual langsung diberi tahu tentang setiap pembatalan
yang terlambat. Namun, pengguna mungkin masih memenuhi syarat untuk mendapatkan pengembalian dana atas setoran mereka hingga 4 jam sebelumnya (14.400 detik) sebelum pemesanan (dengan menghubungi Anda atau penjual untuk melakukan pembatalan), yang akan ditampilkan dalam persyaratan saat checkout dan dalam email konfirmasi.
Untuk mengetahui cara menentukan deposit di tingkat ketersediaan, lihat Mengganti Harga pada Tingkat Ketersediaan.
Perlu diketahui juga bahwa, seperti denda ketidakhadiran, deposit dapat ditagih dengan tarif tetap atau tarif per orang. Dalam hal ini, setoran memiliki suku bunga tetap sebesar
$25, seperti yang ditentukan oleh "deposit_type": "FIXED_RATE_DEFAULT". Jika pemesanan mencakup jumlah tamu di pesta, deposit dapat ditentukan sebagai deposit per orang dengan menetapkan "deposit_type": "PER_PERSON".
Memerlukan Kartu Kredit
Layanan mungkin memerlukan kartu kredit sebagai cara tambahan untuk memverifikasi identitas. Namun, kartu ini tidak boleh digunakan untuk pembayaran di muka, setoran, atau biaya ketidakhadiran tamu. Jika kasus penggunaan tersebut diperlukan, kasus tersebut harus dikonfigurasi secara eksplisit. Mewajibkan kartu kredit sering kali akan menyebabkan penurunan pemesanan yang signifikan untuk layanan ini.
Untuk mewajibkan kartu kredit diberikan saat checkout, Anda harus menetapkan kolom require_credit_card ke REQUIRE_CREDIT_CARD_ALWAYS.
{
"merchant_id": "merchant-1",
"service_id": "reservation",
"name": "reservation",
"description": "Food reservation",
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
Mengganti Harga pada Tingkat Ketersediaan
Struktur harga dan biaya ditentukan di tingkat Layanan. Biasanya, harga tingkat layanan ini harus digunakan. Namun, sebaiknya ubah struktur pembayaran untuk slot ketersediaan tertentu. Misalnya, situasi berikut dapat ditangani dengan mengganti harga atau biaya di tingkat ketersediaan:
- Harga diturunkan pada hari Selasa dan naik pada hari Sabtu.
- Tidak ada biaya pertunjukan yang berlaku untuk ketersediaan antara pukul 17.00 dan 19.00.
- Memerlukan setoran untuk jumlah tamu di atas 6 orang.
- Pemesanan di kamar tertentu memerlukan kartu kredit.
Tabel jenis pembayaran mencantumkan kolom yang digunakan di feed ketersediaan untuk mengganti definisi tingkat layanan, untuk setiap metode pembayaran / biaya.
| Jenis Pembayaran | Definisi Feed | Dapat diganti? |
|---|---|---|
| Pembayaran di muka | Availability.prepayment | Tidak Dapat Diganti |
| Denda Ketidakhadiran | Service.no_show_fee | Availability.no_show_fee |
| Deposit | Service.deposit | Availability.deposit |