# Options
# Options list
Kirby Pay comes with many options to configure to achieve proper operation according to the needs of each project scenario. All the options needs the prefix beebmx.kirby-pay
.
Option | Default | Value | Description |
---|---|---|---|
name | Business | (string) | Set the default name of the buisness |
env | production | (string) | Set the current enviroment. Accepts local , test or production |
service | sandbox | (string) | Set the service used to process payments: sandbox , stripe or conekta |
service_key | null | (string) | Set the public key of the service |
service_secret | null | (string) | Set the secret key of the service |
locale | en_US | (string) | Set the locale for the services |
locale_code | en | (string) | Set the code for Kirby localization |
currency | usd | (string) | Set the currency with ISO 4217 |
money_precision | 2 | (int) | Set the precision for the money |
date_format | Y-m-d H:m:s | (string) | Set the date format for the panel display |
default_item_name | Item to sell | (string) | Set the default item name for the products or services |
shipping | false | (bool) | Hide or show shipping options in the form |
default_country | null | (string) | If shipping is enable set the default country selected (ISO 3166-1 2 letters country code) |
countries | null | (array) | Define only the countries you need to ship (ISO 3166-1 2 letters country code) |
payment_types | ['card'] | (array) | Set the allowed method payments |
payment_process | charge | (string) | Set the process of the payment charge or order |
payment_expiration_days | 30 | (int) | Set the expiration days for oxxo_charge in conekta service |
pay_id_length | 6 | (int) | Set the length to display in panel |
pagination | 10 | (int) | Set the number of rows to be displayed per page in the panel |
redirect | thanks | (string) | Set the URL to redirect if the payment was successful |
redirect_customer_create | customer | (string) | Set the URL to redirect if the customer was created |
redirect_customer_update | profile | (string) | Set the URL to redirect if the customer was updated |
redirect_source_update | profile | (string) | Set the URL to redirect if the source payment was updated |
storage | /pay | (string) | Set the location where payment files will be stored |
extra_amounts_item | Extra | (string) | Extra item label |
logs | false | (bool) | Enable or disable webhooks logs |
styles | (array) | Update default styles |
# Example
Here is an example to configure the stripe
driver. In your Kirby configuration file config.php
just add:
$base = dirname(dirname(__DIR__));
$storage = $base . '/storage/pay';
return [
'beebmx.kirby-pay.service' => 'stripe',
'beebmx.kirby-pay.service_key' => 'pk_test_stripe_key',
'beebmx.kirby-pay.service_secret' => 'sk_test_stripe_secret',
'beebmx.kirby-pay.default_country' => 'US',
'beebmx.kirby-pay.storage' => $storage,
'beebmx.kirby-pay.env' => 'test',
'beebmx.kirby-pay.logs' => true
];