Asuransi Taruhan - Portal Dokumentasi

Informasi Umum

Asuransi taruhan adalah fitur taruhan yang memungkinkan pemain mengasuransikan taruhan mereka dan menerima pembayaran jika kalah.

Informasi tentang semua tindakan terkait asuransi taruhan disimpan di Platform Taruhan (misalnya, asuransi yang tersedia dan belum digunakan, semua asuransi pada taruhan pemain).

Contoh: Saat pemain memasang taruhan, mereka ditawari untuk mengasuransikan taruhan sebesar 10% dari jumlah taruhan (pihak pengintegrasi dapat menetapkan persentase atau jumlah tetap asuransi) → pemain bertaruh 100 UAH dan memilih untuk mengasuransikan taruhannya. Jika taruhan kalah, 10 UAH akan dikreditkan ke akun pemain.

Asuransi Taruhan

Jenis asuransi (jumlah tetap atau persentase dari jumlah taruhan) dipilih saat taruhan ditempatkan di slip taruhan.

Jumlah pembayaran asuransi/persentase pengembalian ditetapkan oleh pihak pengintegrasi.

• Pemain dapat memasang taruhan dengan parameter tertentu yang ditetapkan oleh pihak pengintegrasi. Contoh: jika Anda menetapkan parameter: olahraga - sepak bola, jumlah taruhan - 10 EUR, maka saat menambahkan taruhan yang memenuhi parameter tersebut ke slip taruhan, pemain dapat memilih asuransi yang tersedia.
• Jika pemain menerapkan asuransi pada taruhan tertentu, taruhan dianggap diasuransikan setelah penempatan. Jika asuransi telah diterapkan, asuransi dianggap digunakan dan tidak lagi tersedia.
• Jika taruhan yang ingin diasuransikan tidak diterima karena alasan apa pun, asuransi TIDAK digunakan dan dapat diterapkan pada taruhan lain.

Setelah akhir acara olahraga tempat taruhan yang diasuransikan ditempatkan, penyelesaian taruhan berikut mungkin terjadi:

• Taruhan berhasil: pemain menerima pembayaran jumlah kemenangan. Platform Taruhan akan mengirimkan panggilan balik bet/insurances/decline agar pihak pengintegrasi menandai asuransi sebagai ditolak.
• Taruhan kalah: pemain menerima jumlah asuransi (persentase dari jumlah taruhan atau jumlah tetap). Platform Taruhan akan mengirimkan panggilan balik bet/insurances/accepted agar pihak pengintegrasi mengisi ulang saldo pemain.
• Taruhan dikembalikan: jumlah taruhan dikembalikan ke pemain. Platform Taruhan akan mengirimkan panggilan balik bet/insurances/decline agar pihak pengintegrasi menandai asuransi sebagai ditolak.

Diagram siklus hidup asuransi taruhan

Implementasi pada Platform Taruhan

Algoritma pembayaran asuransi jika taruhan kalah:

• Setelah pertandingan selesai dan taruhan kalah, Platform Taruhan menganalisis jumlah atau persentase taruhan yang harus dibayarkan kepada pemain.
• Platform Taruhan mengirimkan permintaan ke pihak pengintegrasi untuk mengakumulasi asuransi ini.
• Jumlah atau persentase taruhan dibayarkan kepada pemain. Jumlah/persentase yang dikembalikan akan ditampilkan di akun pemain.
• Jika pertandingan selesai tetapi skor pertandingan dibatalkan, Platform Taruhan mengirimkan permintaan ke pihak pengintegrasi untuk membatalkan jumlah asuransi yang telah diakumulasi.

Kondisi

Pemain dapat diberikan kesempatan untuk mengasuransikan taruhan mereka jika memenuhi kondisi yang ditetapkan oleh pihak pengintegrasi. Untuk membuat permintaan asuransi taruhan, pihak pengintegrasi harus mengirimkan kondisi berikut dalam metode post/insurance/create dan post/insurance/update:

Selain itu, untuk asuransi taruhan, perlu mengirimkan kondisi pembayaran asuransi tergantung pada strategi yang dipilih. Ada dua strategi asuransi:

• RefundAmountAmountRule – jumlah tetap dibayarkan;
• RefundAmountPercentRule – persentase dari jumlah taruhan dibayarkan, tetapi tidak melebihi nilai bidang max_amount.

API Callback

Penting

Harap pastikan semua panggilan balik diproses secara idempoten. Karena jaminan setidaknya sekali, panggilan balik dapat dikirim ke server lebih dari sekali. Selalu gunakan request_id untuk membedakan dan mengelola setiap panggilan balik dengan tepat. Jika permintaan terduplikasi, sangat penting untuk merespons dengan kode respons dan konten yang sama seperti respons awal. Konsistensi dalam menangani dan merespons permintaan berulang memastikan operasi yang lancar.

Panggilan balik asuransi taruhan SEBAIKNYA diimplementasikan di sisi integrasi hanya jika fungsi tersebut diperlukan.

Contoh cURL

Ganti {callback-api-server} dengan URL server API panggilan balik Anda dan jalankan perintah berikut untuk menguji panggilan balik asuransi taruhan:

Asuransi taruhan diterima

curl -X 'POST' \http://{callback-api-server}/bet/insurances/accepted \-H 'accept: */*' \-H 'Foreign-Params: { "session_id": "some_session_id", "any_extra_value": "123" }' \-H 'Content-Type: application/json' \-d '{ "request_id": "550e8400-e29b-41d4-a716-446655440000", "bet_id": "AAAAAAAAAAAAAAAAAaVSZ1rf1k0BuhAAAOAdRQAY", "bet_insurance_id": "129965e5-4279-4a85-a454-89f58192799d", "refund_amount": "5.5"}'

Asuransi taruhan ditolak

curl -X 'POST' \http://{callback-api-server}/bet/insurances/decline \-H 'accept: */*' \-H 'Foreign-Params: { "session_id": "some_session_id", "any_extra_value": "123" }' \-H 'Content-Type: application/json' \-d '{ "request_id": "550e8400-e29b-41d4-a716-446655440000", "bet_id": "AAAAAAAAAAAAAAAAAaVSZ1rf1k0BuhAAAOAdRQAY", "bet_insurance_id": "129965e5-4279-4a85-a454-89f58192799d"}'

API CRUD