# Bagaimana cara menghubungkan Culqi ke toko saya?

Culqi memungkinkan pelanggan di Peru membayar dengan kartu, Yape, atau PagoEfectivo di halaman checkout Culqi, menggunakan akun Culqi Anda sendiri. Culqi menagih dalam sol (PEN) atau dolar AS (USD), sehingga hanya muncul saat checkout jika harga Anda menggunakan salah satu mata uang tersebut.

## Langkah-langkah

1. Di **CulqiPanel > Development > API keys**, salin **public key** dan **secret key**. Kunci uji diawali dengan `pk_test_` dan `sk_test_`.
2. Di Dropify, buka **Aplikasi**, cari **Culqi** lalu klik **Instal dan hubungkan**.
3. Di halaman aplikasi, klik **Hubungkan Culqi**, ketik **Nama akun**, isi **Public key** dan **Secret key**, lalu klik **Tambah akun**. Dropify memeriksa kunci tersebut ke Culqi sebelum menyimpan.
4. Direkomendasikan: di bawah **URL Webhook**, klik **Salin URL webhook** lalu tambahkan di Culqi (**CulqiPanel > Events > Webhooks**, event order.status.changed dan charge.creation.succeeded). Pembayaran PagoEfectivo dikonfirmasi melalui webhook ini.
5. Di bagian **Pengaturan**, pilih **Mode Sandbox** untuk menguji atau **Mode Live** untuk pembayaran asli, dengan kunci yang sesuai.
6. Buka **Pembayaran > Metode pembayaran** lalu aktifkan Culqi. Anda juga dapat mengatur **Diskon untuk pesanan pra-bayar** untuk metode ini.
7. Buat pesanan uji coba dalam PEN atau USD lalu bayar di halaman uji Culqi.

## Masalah umum

- "Culqi menolak kunci ini dalam mode uji…" → kunci berasal dari mode yang lain, atau tersalin bersama spasi. Salin lagi kuncinya atau ganti mode di **Pengaturan**.
- Culqi tidak muncul saat checkout → harga Anda (atau mata uang pengunjung) bukan dalam PEN atau USD, atau Culqi dinonaktifkan di **Pembayaran > Metode pembayaran**.
- Pelanggan melihat "Anda membatalkan pembayaran. Anda dapat mencoba lagi atau memilih metode pembayaran lain." → pembayaran dibatalkan di halaman Culqi. Jika pelanggan hanya meninggalkan halaman, pesanan tetap berstatus tertunda.
- Pesanan yang dibayar belakangan tetap berstatus belum dibayar → webhook belum ada di Culqi. Tambahkan URL webhook yang tertera di halaman aplikasi (langkah 4).

## Terkait

- [Bagaimana cara menghubungkan Openpay ke toko saya?](https://help.dropify.shop/id/payments_gateways/openpay/)
- [Bagaimana cara menghubungkan PayU ke toko saya?](https://help.dropify.shop/id/payments_gateways/payu-latam/)
- available payment gateways by country
