Untuk menggunakan sistem pembayaran Mercado Pago, lengkapi tetapan di bawah dalam papan pemuka Mercado Pago Developers anda dan kemudian masukkan butiran dalam tetapan integrasi.
Aplikasi dan Token Akses
- Log masuk ke Mercado Pago dan buka bahagian Developers (Developers / Suas integrações).
- Cipta aplikasi (Your integrations → Create application) jika anda belum memilikinya.
- Salin Production Access Token atau Test Access Token anda — token ini akan digunakan sebagai token API utama.
Untuk maklumat tentang jenis token dan tempat mencarinya, lihat: Credentials.
Webhooks (pemberitahuan pembayaran)
- Dalam tetapan integrasi, buka bahagian Webhooks / уведомления (lihat: Webhooks).
- Tetapkan URL pemberitahuan:
https://chatter.mavibot.ai/mercado_pago_callback/result
- Langgan acara Payments supaya anda boleh menerima pemberitahuan tentang penciptaan pembayaran dan kemas kini status.
- Simpan Webhook secret — ia mesti dimasukkan dalam tetapan integrasi.
Menyambung ke Mavibot
Dalam bahagian Acquiring, pilih Mercado Pago.
Kemudian masukkan:
- Access Token — token yang anda salin.
- Webhook secret — rahsia yang digunakan untuk mengesahkan webhooks.
Penjanaan pautan pembayaran
Fungsi kalkulator:
get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)
Fungsi mengembalikan pautan pembayaran.
Pembayaran melalui butang
Untuk menghantar butang pembayaran melalui Mercado Pago, pilih jenis butang dengan sokongan pembayaran dalam pembina butang dan pilih Mercado Pago sebagai sistem pembayaran. Masukkan jumlah, penerangan, dan mata wang jika perlu.
Panggil balik dalam dialog selepas pembayaran
Pembayaran berjaya
Selepas pelanggan mengikuti pautan dan melengkapkan pembayaran yang berjaya, panggil balik boleh dihantar ke dialog dalam format berikut:
<first_10_characters_of_Webhook_secret>_success <amount>
Contoh:
gltubgnDle_success 100 — di mana awalan ialah 10 aksara pertama Webhook secret anda, dan 100 ialah jumlah pembayaran.
Cara menambah reaksi kepada pembayaran berjaya
Untuk menghantar mesej kepada pelanggan anda selepas pembayaran berjaya (contohnya, “Pembayaran berjaya diselesaikan” atau sebarang mesej lain), anda perlu menyediakan reaksi menggunakan blok dengan pencetus dan panggil balik.
Langkah 1
Cipta blok dengan syarat (Blok Mula atau Blok Pencetus).
Langkah 2
Nyatakan sebahagian daripada panggil balik (jika anda perlu bertindak balas kepada semua pembayaran, cth. apabila anda mempunyai pelbagai produk berbeza), atau panggil balik penuh (jika anda ingin menyediakan reaksi hanya untuk jualan produk tertentu).
Langkah 3
Tulis mesej respons untuk pembayaran berjaya dan simpan blok.
Pembayaran gagal
Jika pembayaran tidak berjaya (ditolak, dibatalkan, dsb., bergantung pada status dalam API), panggil balik boleh dihantar dalam format berikut:
<first_10_characters_of_Webhook_secret>_fail <amount>
Contoh:
gltubgnDle_fail 100 — di mana awalan ialah 10 aksara pertama Webhook secret anda, dan 100 ialah jumlah.
Cara menambah reaksi kepada pembayaran gagal
Untuk menghantar mesej kepada pelanggan anda selepas pembayaran tidak berjaya (contohnya, “Pembayaran gagal” atau sebarang mesej lain), anda perlu menyediakan reaksi menggunakan blok dengan pencetus dan panggil balik.
Reaksi pembayaran gagal dikonfigurasikan dengan cara yang sama seperti pembayaran berjaya.
Langkah 1
Cipta blok dengan syarat (Blok Mula atau Blok Pencetus).
Langkah 2
Nyatakan sebahagian daripada panggil balik (jika anda perlu bertindak balas kepada semua pembayaran, cth. apabila anda mempunyai pelbagai produk berbeza), atau panggil balik penuh (jika anda ingin menyediakan reaksi hanya untuk jualan produk tertentu).
Langkah 3
Tulis mesej respons untuk pembayaran gagal dan simpan blok.
Pembolehubah pelanggan selepas pembayaran berjaya
| Pembolehubah | Penerangan |
|---|---|
| mercado_pago_callback_data | Maklumat pembayaran yang diterima daripada sistem pembayaran. |
| mercado_pago_payment_completed | “True” — pembayaran telah diproses sebagai berjaya. |
| mercado_pago_payment_id | ID pembayaran Mercado Pago |