Bold Payment Gateway by Codeupp for Columbia

# Bold.co Payment Gateway Plugin for Botble

**Plugin ID:**`codeupp/bold`

**Namespace:**`Codeupp\Bold\`

**Author:** Maryam International LLC — [codeupp.xyz](https://codeupp.xyz)

Accept online payments via **Bold.co** (Colombia's leading payment processor) directly in your Botble/Martfury/Shofy/Nest ecommerce store.

---

## Supported Payment Methods

-**Credit / Debit Card** (Visa, Mastercard, Amex)

-**PSE** (ACH Bank Transfer)

-**Bancolombia Button**

-**Nequi** (Push / QR)

-**Daviplata**

---

## Integration Type

**API Payment Link** (`POST /online/link/v1`)

The customer is redirected to Bold's hosted checkout page where they select their preferred payment method and complete the transaction. After payment, Bold redirects back to your store and sends a webhook notification.

---

## Features

-**Test & Live Mode** — switch between sandbox and production with separate API keys

-**Configurable Payment Methods** — enable/disable individual methods per store

-**Payment Link Expiry** — set how long links stay active (5 min – 24 hours)

-**Webhook + Callback** — dual confirmation for maximum reliability

-**Wallet Top-up Support** — works with the e-wallet plugin for customer wallet top-ups

-**Country Restrictions** — uses Botble's built-in available-countries filter

-**Test Connection** — admin button to verify API connectivity

---

## Installation

1. Copy the `BOLDBYCODEUPP` folder to `platform/plugins/`

2. Go to **Admin → Plugins** and activate **Bold Payment Gateway by Codeupp**

3. Go to **Admin → Settings → Payment Methods** and configure Bold:

- Set Environment Mode (Live or Test)

- Paste your **Identity Key (API Key)** from the Bold Dashboard

- Select which payment methods to offer

- Set link expiry time

4. Save settings

---

## Getting API Keys

1. Log in to [https://bold.co](https://bold.co)

2. Navigate to **Dashboard → Integration Keys**

3. Copy the **Identity Key** for production

4. For test mode, copy the key from **Test Integration Keys**

---

## Webhook Setup

Bold.co will send webhook notifications to:

```

https://yourstore.com/payment/bold/webhook

```

Set this URL in your Bold Dashboard → Webhooks.

---

## Files

| File | Purpose |

|---|---|

| `plugin.json` | Plugin metadata |

| `helpers/constants.php` | Helper functions (mode, base URL, API key, payment methods) |

| `src/Providers/BoldServiceProvider.php` | Service provider registration |

| `src/Providers/HookServiceProvider.php` | Payment hooks (register method, checkout handler, enums, CSRF exempt) |

| `src/Forms/BoldPaymentMethodForm.php` | Admin settings form |

| `src/Services/Abstracts/BoldPaymentAbstract.php` | Abstract base class |

| `src/Services/Gateways/BoldPaymentService.php` | API client + payment link creation |

| `src/Http/Controllers/BoldController.php` | Callback, webhook, test connection |

| `routes/web.php` | Routes |

| `resources/views/` | Blade views (methods, instructions, detail) |

| `resources/lang/en/bold.php` | Translations |

| `public/images/bold.svg` | Payment method logo |

---

## Compatibility

- Botble CMS ≥ 7.3.0

- Martfury / Shofy / Nest themes

- E-Wallet plugin (optional, for wallet top-ups)

---

## Branding

**Maryam International LLC**

Website: [www.codeupp.xyz](https://www.codeupp.xyz)