How do I connect Culqi to my store?
Culqi lets customers in Peru pay by card, Yape or PagoEfectivo on Culqi's checkout, using your own Culqi account. It charges in soles (PEN) or US dollars (USD), so it appears at checkout only when your prices are in one of those currencies.
Steps
- In CulqiPanel > Development > API keys, copy the public key and the secret key. Test keys start with
pk_test_andsk_test_. - In Dropify, go to Apps, find Culqi and click Install and connect.
- On the app page click Connect Culqi, type an Account name, fill in Public key and Secret key, then click Add account. Dropify checks the keys with Culqi before saving.
- Recommended: under Webhook URL click Copy webhook URL and add it in Culqi (CulqiPanel > Events > Webhooks, events order.status.changed and charge.creation.succeeded). PagoEfectivo payments are confirmed through it.
- In the Settings section choose Sandbox Mode to test or Live Mode for real payments, with the matching keys.
- Go to Payments > Payment methods and switch Culqi on. You can also set a Discount for prepaid orders for it.
- Place a test order in PEN or USD and pay on the Culqi test page.
Common problems
- "Culqi rejected these keys in test mode…"keys of the other mode, or copied with spaces. Copy them again or switch the mode in Settings.
- Culqi does not show at checkoutyour prices (or the visitor's currency) are not in PEN or USD, or Culqi is switched off in Payments > Payment methods.
- The customer sees "You cancelled the payment. You can try again or choose another payment method."the payment was cancelled on the Culqi page. If they only left the page, the order stays pending.
- An order paid later stays unpaidthe webhook is missing in Culqi. Add the webhook URL shown on the app page (step 4).