How to Connect Your Own PayMongo Account

Updated
Feature Availability User Permissions Time to Complete Skill Level
Philippine stores on Launch, Grow, Scale and Trial. Not available on Free Store owner, or a team member with Billing access About 10 minutes Intermediate

Summary

Overview: If you have your own PayMongo account, you can connect it to your store with your PayMongo secret API key. You choose which payment methods customers can use, such as GCash, Maya or cards. Customers then pay on PayMongo's secure payment page, and the money goes straight into your own PayMongo account.

Prerequisites:

  • A Philippine store on the Launch, Grow, Scale or Trial plan.
  • Store owner access, or a team member with Billing access.
  • Your own PayMongo account, with the payment methods you want to offer activated on it.
  • Your PayMongo live secret API key. It starts with sk_live_. Test keys (sk_test_…) can't be connected.

Step-by-Step Instructions

Step 1: Open the PayMongo page

  1. In the sidebar, click Settings, then Payments.
  2. Under Prosperna Payments, find the PayMongo card. Before you connect, it shows Not Connected.
  3. Click Manage.

The PayMongo page opens.

Step 2: Copy your secret API key from PayMongo

  1. Sign in to your PayMongo dashboard.
  2. Find your API keys and copy your live secret key (it starts with sk_live_). Copy the whole key.

Don't use the public key (pk_…). Prosperna needs the secret key.

Step 3: Enter your key and choose payment methods

  1. Paste your key into Secret API Key.
  2. Under Payment methods, tick the methods customers can pay with. GCash, Maya and Credit/Debit Card are ticked for you. You can choose from:
    • E-wallets and QR: GCash, Maya, GrabPay, ShopeePay, QR Ph
    • Cards: Credit/Debit Card (Visa and Mastercard)
    • Online banking and BNPL: BPI Online Banking, UnionBank Online Banking, BillEase
  3. Tick at least one method. Each method you tick must also be activated on your PayMongo account. Cards and GCash need a registered business on your PayMongo account, and online banking and BNPL methods need approval from PayMongo support before they work.
  4. Click Connect. Prosperna checks your key with PayMongo before saving it, so this can take a few seconds.
  5. When it works, you see PayMongo account connected.

To leave without connecting, click Back.

Step 4: Check your connection details

After you connect, the page shows:

  • a Connected badge and Your PayMongo account is verified and connected.
  • Mode: Live
  • API key ending with the last four characters of your key
  • Connected on with the date
  • Enabled methods: the payment methods you ticked

Your full key is never shown again after you save it. Prosperna also sets up a payment webhook on your PayMongo account automatically, so you don't need to add one yourself.

Step 5: See what your customers get at checkout

  1. On your store's checkout page, customers see a payment option called PayMongo.
  2. When they choose it, they see You'll be redirected to a secure payment page to complete your order.
  3. After they place the order, they go to PayMongo's payment page and pay with one of the methods you enabled.

Step 6: Follow your PayMongo orders

You don't need to confirm PayMongo payments yourself. Prosperna updates each order automatically:

  • When the order is placed: the payment status is Awaiting Payment.
  • When the customer pays: the payment status changes to Paid, stock is updated and the customer gets an order confirmation email.
    • Orders with physical products shipped by a courier (Standard Delivery, Same Day Delivery, Scheduled Delivery or USPS) move to Processing. For Store Pickup and Manual Shipping orders, update the order status yourself as usual.
    • Orders that contain only digital products move to Completed.
  • When the customer doesn't pay: the order stays Awaiting Payment. PayMongo's payment page has no time limit, so Prosperna doesn't close the order by itself. If you no longer expect the payment, open the order and click Cancel Order. The payment status changes to Declined Payment only when PayMongo reports the payment as failed.
  • When PayMongo can't create the payment page: the order is cancelled automatically and its payment status is Declined Payment.

Prosperna checks PayMongo every 15 minutes for orders from the last 3 days that are still waiting, so an order is updated even if a payment notice from PayMongo is missed.

Payments go straight to your PayMongo account. They are not added to your Prosperna balance. Manage payouts and refunds in your PayMongo dashboard.

Step 7: Change your key or payment methods (optional)

  1. Open the PayMongo page again (Step 1).
  2. Click Update key.
  3. Paste your key again. Use your current key to keep it, or a new key if you created one in PayMongo.
  4. Tick or untick payment methods.
  5. Click Save. To close the form without changes, click Cancel.

If you create a new secret key in your PayMongo dashboard, PayMongo stops accepting the old one. Update your key here right away, or customers can't pay with PayMongo.

Step 8: Disconnect your PayMongo account (optional)

  1. Open the PayMongo page (Step 1).
  2. Click Disconnect.
  3. In the Disconnect PayMongo account window, read the message: customers will no longer be able to pay through your PayMongo account, and your API key will be removed.
  4. Click Disconnect. You see PayMongo account disconnected.

The PayMongo option disappears from checkout. You can connect again at any time by repeating Step 3.

Verify It Worked

Success criteria:

  • You saw PayMongo account connected.
  • The PayMongo page shows the Connected badge, Mode: Live and the methods you ticked.
  • Back on Settings → Payments, the PayMongo card shows Connected.
  • On your store's checkout page, PayMongo appears as a payment option.

Troubleshooting

Common errors

  • "Please enter your PayMongo secret API key.": the Secret API Key box is empty. Paste your key and click Connect again.
  • "Please select at least one payment method.": tick at least one method under Payment methods.
  • "That does not look like a PayMongo secret key.": the key doesn't start with sk_live_ or sk_test_. Make sure you copied the secret key, not the public key.
  • "Test keys cannot be connected on the live platform.": you pasted a test key (sk_test_…). Use your live secret key (sk_live_…).
  • "PayMongo rejected this API key. Double-check you copied the full secret key.": PayMongo didn't accept the key. Copy the whole key again. If you recently created a new key in PayMongo, use the new one.
  • "We could not validate this key with PayMongo right now. Please try again.": Prosperna couldn't reach PayMongo. Wait a moment and try again.
  • "Your PayMongo key works, but we could not register the payment webhook on your PayMongo account. Please try again.": the key is fine, but setting up the payment webhook failed. Try again.
  • "Failed to disconnect.": the account was not disconnected. Try again.
  • The PayMongo page shows "Connection broken" and "PayMongo rejected the API key saved here. Re-enter your key to reconnect.": PayMongo no longer accepts the key you saved, usually because a new key was created in your PayMongo dashboard. Customers can't choose PayMongo until you fix it, and orders that are still waiting for payment aren't updated until you do. Click Re-enter key, paste your current secret key, and click Save.
  • A customer sees "We could not start the payment with this gateway. Please try another payment method.": PayMongo couldn't create the payment page for that order, so the order was cancelled automatically. This also happens when the order total isn't in Philippine pesos (PHP). Check the PayMongo page for a Connection broken badge, and check that the methods you ticked are activated on your PayMongo account.
  • A customer can't pay with a method you ticked: the method may not be activated on your PayMongo account yet. Activate it in PayMongo, or untick it with Update key.
  • A customer paid after the order was cancelled: the order stays Cancelled. A note on the order asks you to refund the customer from your PayMongo dashboard.

Limitations & considerations

  • Only Philippine stores can connect their own PayMongo account, and it only accepts payments in Philippine pesos (PHP).
  • A method only works when it is both ticked here and activated on your PayMongo account.
  • You can't change the payment status of these orders by hand. Prosperna updates it from PayMongo.
  • Refunds aren't made from Prosperna. Refund the customer from your PayMongo dashboard.
  • PayMongo isn't offered for QR menu (table) orders.
  • If you book a Prosperna courier for one of these orders, the delivery fee is paid from your Shipping Credits.

Next Steps & Related Resources


Need more help? For more information and assistance, please send an email to support@prosperna.com.

Last Updated: 11/19/2026