# Culqiをストアに連携する方法

Culqiを使うと、ペルーのお客様は、あなた自身のCulqiアカウントを通じて、Culqiの決済画面でカード、Yape、PagoEfectivoで支払えます。請求通貨はソル（PEN）または米ドル（USD）のため、価格がこのいずれかの通貨の場合にのみ購入手続き画面に表示されます。

## 手順

1. **CulqiPanel > Development > API keys** で、 **公開鍵** と **シークレットキー** をコピーします。テストキーは `pk_test_` と `sk_test_` で始まります。
2. Dropifyで **アプリ** に移動し、 **Culqi** を見つけて **インストールして連携** をクリックします。
3. アプリページで **Culqi を連携** をクリックし、 **アカウント名** を入力して、 **公開鍵** と **シークレットキー** を入力し、 **アカウントを追加** をクリックします。Dropifyは保存前にCulqiでキーを確認します。
4. 推奨： **Webhook URL** の下にある **Webhook URLをコピー** をクリックし、Culqiに追加します（ **CulqiPanel > Events > Webhooks** 、イベントは order.status.changed と charge.creation.succeeded）。PagoEfectivoの支払いはこのWebhookを通じて確認されます。
5. **設定** セクションで、テストする場合は **サンドボックスモード** 、実際の決済を受け付ける場合は **ライブモード** を選び、モードに合ったキーを使います。
6. **決済 > 決済方法** に移動し、Culqiをオンにします。Culqiに **前払い注文の割引** を設定することもできます。
7. PENまたはUSDでテスト注文を行い、Culqiのテストページで支払います。

## よくある問題

- 「Culqiがテストモードでこれらのキーを拒否しました…」 → 別のモードのキーであるか、スペースを含めてコピーされています。もう一度コピーするか、 **設定** でモードを切り替えてください。
- Culqiが購入手続き画面に表示されない → 価格（または訪問者の通貨）がPENまたはUSDではないか、 **決済 > 決済方法** でCulqiがオフになっています。
- お客様に「支払いをキャンセルしました。もう一度お試しいただくか、別の決済方法をお選びください。」と表示される → Culqiのページで支払いがキャンセルされました。お客様がページを離れただけの場合、注文は保留中のままです。
- 後から支払われた注文が未払いのままになる → CulqiにWebhookが設定されていません。アプリページに表示されているWebhook URLを追加してください（手順4）。

## 関連記事

- [Openpayをストアに連携する方法](https://help.dropify.shop/ja/payments_gateways/openpay/)
- [PayUをストアに連携する方法](https://help.dropify.shop/ja/payments_gateways/payu-latam/)
- available payment gateways by country
