> ## Documentation Index
> Fetch the complete documentation index at: https://docs.9pic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PayMongo Setup

> Add PayMongo credentials to 9Pic Checkout and prepare a PHP event for test or live payments.

> [!WARNING]
>
> 9Pic Checkout is a **Business plan** feature. Only team admins can add or change a PayMongo configuration.

## Overview

PayMongo collects payments for 9Pic Checkout in the Philippines. Add one PayMongo configuration for your organisation, then assign it to the event that will sell packages in **PHP**.

You need a **secret key** from the PayMongo Dashboard. Use a test key while you check the buyer journey, and a live key only when the event is ready to accept real payments.

## Before You Start

| Requirement | Why it matters |
| - | - |
| **PayMongo merchant access** | You need permission to view **Developers -> API keys** in the PayMongo Dashboard. |
| **Correct mode** | Use a `sk_test_…` key for setup checks. Use a separate `sk_live_…` key for public checkout. |
| **A team admin account** | Only team admins can open and manage Payment Configuration. |
| **A Business or Enterprise organisation** | Payment Configuration and 9Pic Checkout are available on the Business plan, and on Enterprise. |
| **PHP packages** | Events that use PayMongo can only sell packages priced in PHP. |

> [!WARNING]
>
> Do not share the secret key in email, chat, task tickets, screenshots, frontend code, or a public repository. If you think it has been exposed, create a new key in PayMongo and update the configuration in 9Pic.

## Get Your PayMongo Secret Key

**1. Open API keys in PayMongo**

Sign in to the PayMongo Dashboard and open **Developers -> API keys**.

**2. Copy the secret key for the mode you need**

Copy the **secret key** for test mode or live mode. Test keys start with `sk_test_`. Live keys start with `sk_live_`.

**3. Store the key safely**

Keep the key in your organisation's approved password manager until you add it to 9Pic. Do not paste it into a buyer-facing website or app.

![PayMongo Dashboard Developers page showing masked Live and Test API Secret Key and Public Key fields](https://assets.9pic.ai/docs/dashboard-guide/payment-config/paymongo-api-keys.webp)

> [!NOTE]
>
> Need help finding the keys in PayMongo? Use the [PayMongo API keys guide](https://docs.paymongo.com/docs/api-keys) or contact the PayMongo team that provisioned your merchant account.

## Add PayMongo to 9Pic

**1. Open Payment Config**

In the dashboard sidebar, select **Payment Config**.

**2. Start a new gateway**

In **Payment Gateway Configurations**, click **Add Gateway**, then select **PayMongo**.

**3. Name the configuration**

Enter an optional **Label** that makes the configuration easy to recognise, such as `PayMongo Test` or `PayMongo Live Philippines`.

**4. Enter an optional Account ID**

**Account ID** is optional for PayMongo. Use it only if your team wants a reminder of which PayMongo account the key belongs to.

**5. Enter the secret key**

Paste the key into **PayMongo Secret Key**. This required value is stored as a protected credential for your organisation.

**6. Create the gateway**

Click **Create Gateway**. The new PayMongo configuration appears in the organisation's gateway list. 9Pic then checks the key with PayMongo, without creating anything, and shows the result under **Secrets**, such as **Key accepted**. See [Key Check](https://docs.9pic.ai/account/payment-gateways.md#key-check) for what each result means.

## Assign PayMongo to an Event

**1. Open the event Checkout configuration**

Open the event, then open its **Checkout** configuration.

**2. Assign the PayMongo configuration**

In the **Payment gateway** card, select **Assign** (or **Edit** if a gateway is already assigned), choose the PayMongo configuration, and save.

**3. Decide whether buyers pay provider fees**

When PayMongo is selected, the **Pass on fees** switch is available. Leave it off to keep the listed package price as the charged amount. Turn it on if buyers should pay the payment-provider fee on the PayMongo page. Package prices stay the same; the total shown on the payment page may increase depending on the payment method.

**4. Set package prices in PHP**

Create or update Checkout packages in **PHP**. Other currencies cannot be used with PayMongo. Each package must be at least PHP 1.00.

**5. Publish and test**

Publish the packages and run a complete buyer journey with a `sk_test_` configuration before you switch the event to a live key.

> [!WARNING]
>
> Replacing the assigned gateway while Checkout is live pauses Checkout first. Confirm the new configuration and package currency before you publish it again.

## Verify the Setup

| Check | What to confirm |
| - | - |
| **Correct mode** | Test events use a `sk_test_` key; public checkout uses a `sk_live_` key. |
| **Payment page opens** | A buyer can continue from 9Pic to the PayMongo hosted payment page. |
| **Payment completes** | A successful test payment returns to 9Pic and marks the order paid. |
| **Currency is PHP** | Package prices and the PayMongo payment page both show PHP. |
| **Buyer methods appear** | Card, GCash, Maya, GrabPay, and QR Ph appear as enabled on your PayMongo account. |
| **Cancellation works** | Cancelling returns the buyer to 9Pic without marking the order paid. |

## Troubleshooting

> [accordion] 9Pic says the PayMongo secret key is not configured.
>
> Edit the PayMongo configuration in **Payment Config** and confirm that **PayMongo Secret Key** has a value. Then assign that configuration on the event's **Payment gateway** card.

> [accordion] My test key does not work for a public event.
>
> A `sk_test_` key is only for setup checks and cannot complete public checkout. Add or update the configuration with a `sk_live_` key from PayMongo live mode.

> [accordion] I cannot select PHP, or another currency is blocked.
>
> Events assigned to PayMongo can only sell PHP packages. Choose PHP, or assign a gateway that supports the currency you need.

> [accordion] The buyer does not see GCash, Maya, GrabPay, or QR Ph.
>
> 9Pic requests those methods when they are available on your PayMongo account. Enable the method in PayMongo, then retry a test purchase.

> [accordion] The payment page total is higher than the package price.
>
> Check whether **Pass on fees** is on for the event. When that switch is on, buyers pay the payment-provider fee and the PayMongo page total can be higher than the listed package price.

## Next Steps

> [card] [Payment Config](https://docs.9pic.ai/account/payment-gateways.md)
>
> Manage the payment gateways saved for your organisation.

> [card] [Checkout Setup](https://docs.9pic.ai/products/checkout/configuration.md)
>
> Assign a gateway, publish packages, and enable Checkout for an event.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.