Untuk menggunakan Klip dalam MaviBot, anda perlu membuat sepasang kelayakan dalam akaun Klip anda dan memasukkannya dalam tetapan sistem pembayaran.
Klip ialah perkhidmatan pembayaran Mexico.
Mendapatkan Kelayakan
Tandatangani perjanjian dengan Klip dan dapatkan akses ke Papan Pemuka Pembangun dalam akaun Klip anda.
Dalam bahagian kelayakan, klik Crear credencial (Buat kelayakan), masukkan nama, dan sahkan penciptaan.
Salin kelayakan berikut:
- Kunci API
- Clave secreta (Kunci rahsia)
Penting! Kunci rahsia hanya dipaparkan sekali, sejurus selepas kelayakan dibuat. Simpan di lokasi yang selamat. Anda tidak boleh melihatnya semula dalam akaun Klip anda. Jika hilang, anda perlu membuat sepasang kelayakan baharu.
Kelayakan dibuat secara berasingan untuk persekitaran pengeluaran dan ujian. Anda boleh membuat sehingga 6 aplikasi setiap akaun.
Untuk ujian integrasi, buat sepasang kelayakan ujian. Untuk menerima pembayaran sebenar, gunakan kelayakan pengeluaran.
Anda tidak perlu mengkonfigurasi URL pemberitahuan pembayaran dalam akaun Klip anda. MaviBot secara automatik menghantar URL pemberitahuan apabila setiap pembayaran dibuat.
Menyambung Klip
Dalam tab Pemerolehan, pilih Klip dan masukkan:
| Medan | Penerangan |
|---|---|
| Kunci API | Pengecam aplikasi. |
| Kunci rahsia (Clave secreta) | Kunci rahsia aplikasi. |
Sambungan kini selesai.
Menjana Pautan Pembayaran
Gunakan fungsi Kalkulator berikut:
get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)
Parameter
| Parameter | Penerangan |
|---|---|
amount |
Jumlah pembayaran. Wajib. Jumlah minimum ialah 1 dalam unit mata wang utama. Nyatakan jumlah sebagai 100.55, bukan 10055. |
description |
Penerangan pembayaran. Pilihan. Panjang maksimum: 250 aksara. Pelanggan boleh melihatnya pada halaman pembayaran dan resit. |
currency |
Kod mata wang tiga huruf (MXN dan mata wang lain yang tersedia untuk akaun Klip anda). Pilihan. Lalai: MXN. |
customer_email |
Alamat e-mel pelanggan. Pilihan. Dimasukkan secara automatik ke dalam borang pembayaran. |
customer_phone |
Nombor telefon pelanggan. Pilihan. Dimasukkan secara automatik ke dalam borang pembayaran. |
full_name |
Nama pelanggan. Pilihan. Dimasukkan secara automatik ke dalam borang pembayaran. |
product_name |
Nama produk. Pilihan. |
language |
Bahasa halaman pembayaran: es untuk Sepanyol (lalai) atau en untuk Inggeris. |
Fungsi ini mengembalikan URL pembayaran.
Butang Pautan Pembayaran
Untuk menghantar butang pembayaran kepada pelanggan:
- Buat butang dengan fungsi Bayar.
- Pilih Klip sebagai sistem pembayaran.
- Nyatakan nama produk, jumlah, dan mata wang.
- Jika perlu, nyatakan pembolehubah yang mengandungi nama, alamat e-mel, dan nombor telefon pelanggan.
Panggil Balik Pembayaran
Selepas pelanggan mengikuti pautan pembayaran dan melengkapkan pembayaran, MaviBot menerima panggil balik.
Pembayaran Berjaya
Contoh:
SDJ91MTKTT_success 100.55
Di mana:
-
SDJ91MTKTT— 10 aksara pertama kunci API anda. -
100.55— jumlah pembayaran.
Pembayaran Gagal
Jika pembayaran tidak berjaya, panggil balik berikut dihantar:
SDJ91MTKTT_fail 100.55
Penting! Panggil balik pembayaran gagal dihantar hanya selepas pautan pembayaran ditutup secara kekal: selepas 5 percubaan pembayaran yang tidak berjaya atau apabila pautan tamat tempoh.
Selagi pelanggan masih mempunyai percubaan pembayaran yang tersedia, pautan kekal aktif dan tiada panggil balik pembayaran gagal dihantar.
Pembolehubah Pelanggan Selepas Pembayaran Berjaya
| Pembolehubah | Penerangan |
|---|---|
clip_callback_data |
Maklumat pembayaran yang diterima daripada sistem pembayaran Klip. |
clip_payment_completed |
"True" jika pembayaran berjaya diproses. |
clip_payment_request_id |
Pengecam pautan pembayaran dalam Klip. |
clip_receipt_no |
Nombor resit Klip. |