For Agents
Accept payments in the Philippines through payment intents, checkout sessions, and refunds supporting GCash, GrabPay, Maya, cards, and bank transfers.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PayMongo Philippines API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with PayMongo Philippines API.
Create payment intents for card and wallet-based transactions with 3D Secure support
Generate hosted checkout sessions with pre-configured payment method options
Process direct payments for immediate charge scenarios
GET STARTED
Use for: I need to accept a payment in the Philippines, I want to create a checkout session with GCash and card options, Process a refund for a Philippine transaction, Get the status of a payment intent
Not supported: Does not handle international payments, subscriptions, invoicing, or multi-currency settlement — use for Philippine peso payment acceptance only.
Jentic publishes the only available OpenAPI specification for PayMongo Philippines API, keeping it validated and agent-ready. The PayMongo API enables businesses to accept online payments in the Philippines through payment intents, checkout sessions, direct payments, and refunds. It supports local payment methods including GCash, GrabPay, Maya, bank transfers, and credit cards, providing 5 endpoints that cover the complete payment lifecycle for Philippine e-commerce.
Issue refunds on completed payments with amount and reason tracking
Accept Philippine local payment methods including GCash, GrabPay, and Maya
Patterns agents use PayMongo Philippines API for, with concrete tasks.
★ Philippine E-Commerce Checkout
Accept payments from Filipino consumers using their preferred payment methods including GCash, GrabPay, Maya, credit cards, and bank transfers. The checkout sessions endpoint generates a hosted payment page with all configured methods displayed. PayMongo handles 3D Secure authentication for cards and wallet redirects for e-wallets, converting at rates above 90% for local methods.
Create a checkout session for 1,500.00 PHP with GCash and card payment methods enabled via POST /checkout_sessions and retrieve the checkout URL
Payment Intent Flow
Use the payment intents pattern for custom checkout experiences where you control the UI. Create a payment intent with amount and currency, attach a payment method on the client side, then confirm the intent to process the charge. This two-step flow supports 3D Secure challenges for cards and wallet authorization redirects while giving full control over the checkout experience.
Create a payment intent for 2,000.00 PHP via POST /payment_intents, then retrieve its status via GET /payment_intents/{id} to verify it awaits payment method attachment
Refund Processing
Issue refunds on completed PayMongo payments for order cancellations, returns, or overpayments. The refunds endpoint accepts the payment ID, refund amount, and reason. Refunds are processed back to the original payment method. For e-wallet payments like GCash, refunds appear in the customer's wallet within minutes.
Issue a refund of 500.00 PHP on a completed payment via POST /refunds with the payment ID and reason as 'customer_request'
AI Agent Philippine Payment via Jentic
AI agents use Jentic to accept payments in the Philippines without managing HTTP Basic authentication or constructing PayMongo API requests manually. Jentic stores the API secret key securely and provides operation schemas so agents can create checkout sessions, process payment intents, and issue refunds with validated Philippine payment parameters.
Search Jentic for 'create a Philippine payment checkout', load the PayMongo checkout sessions schema, and execute it for a 3,000.00 PHP order with GCash and card methods
5 endpoints — jentic publishes the only available openapi specification for paymongo philippines api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/payment_intents
Create a payment intent
/payment_intents/{id}
Retrieve payment intent status
/checkout_sessions
Create a hosted checkout session
/payments
List payments
/refunds
Issue a refund
/payment_intents
Create a payment intent
/payment_intents/{id}
Retrieve payment intent status
/checkout_sessions
Create a hosted checkout session
/payments
List payments
/refunds
Issue a refund
Three things that make agents converge on Jentic-routed access.
Credential isolation
PayMongo API keys (secret and public) are stored encrypted in the Jentic vault (MAXsystem). Agents receive authenticated requests — the raw API keys never enter the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'accept a GCash payment in the Philippines') and Jentic returns the matching PayMongo operation with its input schema including payment method types and PHP currency formatting.
Time to first call
Direct PayMongo integration: 2-3 days for key setup, method configuration, and webhook handling. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Stripe API
Global payment platform with Philippine card processing but limited local method coverage
Choose Stripe when you need global payment acceptance beyond the Philippines or when card-only processing is sufficient without GCash or GrabPay support.
Specific to using PayMongo Philippines API through Jentic.
Why is there no official OpenAPI spec for PayMongo Philippines API?
PayMongo does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call PayMongo Philippines API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the PayMongo API use?
The PayMongo API uses HTTP Basic authentication with your secret API key as the username and an empty password. For public endpoints like creating payment method tokens, use the public key instead. Through Jentic, both keys are stored in the MAXsystem vault and the correct one is used per operation.
Which Philippine payment methods does PayMongo support?
PayMongo supports GCash, GrabPay, Maya (formerly PayMaya), credit and debit cards (Visa, Mastercard), bank transfers, and over-the-counter payments. Each method can be enabled per checkout session. GCash and GrabPay are the most popular e-wallet options with the highest conversion rates in the Philippines.
What are the rate limits for the PayMongo API?
PayMongo applies rate limits per API key. Standard accounts support approximately 100 requests per minute. Test mode has more relaxed limits. The API returns 429 Too Many Requests when exceeded. Jentic handles rate limiting and retry logic when executing operations.
How do I create a checkout session through Jentic?
Search Jentic for 'create a Philippine payment checkout' to find the POST /checkout_sessions operation. Jentic returns the input schema showing required fields like line_items (with amount, name, quantity), payment_method_types (gcash, card, grab_pay), and currency (PHP). Execute through Jentic and receive the checkout URL. Install with pip install jentic.
Can I issue partial refunds with PayMongo?
Yes. The POST /refunds endpoint accepts an amount field allowing partial refunds. You can issue multiple partial refunds on the same payment as long as the total does not exceed the original charge. Provide a reason field for tracking purposes. E-wallet refunds process within minutes.