# PayMongo Documentation > Best developer APIs to build modern payment experiences. Append .md to any documentation page URL to get its markdown version. ## Guides - [What is PayMongo?](https://docs.paymongo.com/docs/get-started-what-is-paymongo.md): Know how PayMongo can help grow your business. - [Product overview](https://docs.paymongo.com/docs/get-started-product-overview.md): See what PayMongo offers and where each piece fits. - [Who is it for?](https://docs.paymongo.com/docs/get-started-who-is-it-for.md): See how PayMongo fits the size and shape of your business. - [What do you want to build?](https://docs.paymongo.com/docs/get-started-what-do-you-want-to-build.md): Start from the job you need done and find the path to ship it. - [Create your account](https://docs.paymongo.com/docs/get-started-create-your-account.md): Open and verify your account and start growing your business. - [Go-live checklist](https://docs.paymongo.com/docs/get-started-go-live-checklist.md): Walk through the milestones for moving your PayMongo integration from test mode to live mode. Links to product-group checklists for details. - [Introduction](https://docs.paymongo.com/docs/payment-acceptance-introduction.md): Build your own checkout experience and accept multiple payment methods directly via the Payment Intent API. - [Key concepts](https://docs.paymongo.com/docs/payment-acceptance-key-concepts.md): Foundational concepts and terminology for Payment Acceptance — what a Payment Intent is, how the payment lifecycle works end-to-end, statuses, messages, webhook events, and key terms used throughout this section. - [Use cases](https://docs.paymongo.com/docs/payment-acceptance-use-cases.md): Real-world examples of how businesses use Payment Acceptance — e-commerce checkouts, mobile app payments, in-store QR payments, and recurring billing scenarios. - [Quick start](https://docs.paymongo.com/docs/payment-acceptance-quick-start.md): The fastest path to accepting your first payment via the Payments API — step-by-step from creating a Payment Intent to handling the result. - [Cards](https://docs.paymongo.com/docs/payment-acceptance-cards.md): Overview of card payments on PayMongo. - [Card vaulting](https://docs.paymongo.com/docs/payment-acceptance-card-vaulting.md): How to store a card token against a Customer object for future use. - [Click to Pay](https://docs.paymongo.com/docs/payment-acceptance-click-to-pay.md): How Click to Pay work at checkout and the customer identity flow. - [Hold then capture](https://docs.paymongo.com/docs/payment-acceptance-hold-then-capture.md): How to authorize a card hold and capture only when you're ready to charge. - [QR Ph](https://docs.paymongo.com/docs/payment-acceptance-qr-ph.md): How QR Ph works on PayMongo — the two variants (dynamic API-driven and static in-store), when to use each, and how payments are confirmed. - [QR Ph API](https://docs.paymongo.com/docs/payment-acceptance-qr-ph-api.md): How to generate a dynamic QR code and receive webhook confirmation or poll for payment status. - [In-store QR Ph](https://docs.paymongo.com/docs/payment-acceptance-in-store-qr-ph.md): How static QR Ph codes work, how to generate them, and how to display them at a physical location. - [E-wallets](https://docs.paymongo.com/docs/payment-acceptance-e-wallets.md): How e-wallets integrate with PayMongo — the integration pattern, how they attach to a Payment Intent, supported providers, and the redirect flow. - [Integrating GCash on mobile applications](https://docs.paymongo.com/docs/payment-acceptance-integrating-gcash-on-mobile.md): How to handle GCash deep links in iOS and Android apps so the redirect flow works correctly inside a WebView. - [Digital wallets](https://docs.paymongo.com/docs/payment-acceptance-digital-wallets.md): How digital wallets on PayMongo — the token flow, security model, and how they differ from e-wallets. - [Google Pay™](https://docs.paymongo.com/docs/payment-acceptance-google-pay.md): How to integrate Google Pay, the security model, and the token flow. - [Buy now, pay later](https://docs.paymongo.com/docs/payment-acceptance-bnpl.md): How Buy Now Pay Later methods work on PayMongo — current providers, how they attach to a Payment Intent, and customer eligibility considerations. - [Direct online banking](https://docs.paymongo.com/docs/payment-acceptance-direct-online-banking.md): How direct online banking works on PayMongo — the redirect flow, supported banks, and how it attaches to a Payment Intent. - [Payment features](https://docs.paymongo.com/docs/payment-acceptance-payment-features.md): Capabilities that build on top of the core Payment Intent workflow. - [Subscriptions](https://docs.paymongo.com/docs/payment-acceptance-subscriptions.md): How to create plans, attach subscriptions, and handle billing cycles. - [Refunds](https://docs.paymongo.com/docs/payment-acceptance-refunds.md): How to issue full or partial refunds via API or dashboard, timelines by payment method, and restrictions that apply. - [QRPH Refunds](https://docs.paymongo.com/docs/qrph-refunds.md): Refund process for QRPH payments - [Payment reconciliation](https://docs.paymongo.com/docs/payment-acceptance-payment-reconciliation.md): How to view, filter, and export your payment records fro PayMongo - [Best practices](https://docs.paymongo.com/docs/payment-acceptance-best-practices.md): The security model for payment acceptance — PCI DSS scope, what PayMongo handles vs what the merchant is responsible for, and best practices for keeping payment data safe across all integration types. - [Errors](https://docs.paymongo.com/docs/payment-acceptance-errors.md): Error codes and payment method-specific failure responses. - [Brankas errors](https://docs.paymongo.com/docs/payment-acceptance-errors-brankas.md): Failed codes for Brankas direct online banking payments. - [Card errors](https://docs.paymongo.com/docs/payment-acceptance-errors-card.md): Decline codes, fraud flags, processor errors, and invalid card detail errors for card payments. - [Direct online banking errors](https://docs.paymongo.com/docs/payment-acceptance-errors-direct-online-banking.md): Error codes for BPI and UnionBank direct online banking payments. - [E-wallet errors](https://docs.paymongo.com/docs/payment-acceptance-errors-ewallet.md): Failed payment codes for GCash, Maya, and ShopeePay. - [Pay Later errors](https://docs.paymongo.com/docs/payment-acceptance-errors-paylater.md): Failed payment codes for Billease. - [QR Ph errors](https://docs.paymongo.com/docs/payment-acceptance-errors-qr-ph.md): Failed payment codes for QR Ph payments. - [Refund errors](https://docs.paymongo.com/docs/payment-acceptance-errors-refund.md): Error codes returned when creating or processing refunds. - [Payment Intent and Payment Method errors](https://docs.paymongo.com/docs/payment-acceptance-errors-pipm.md): Common API errors when creating, attaching, and retrieving payment intents and payment methods. - [Troubleshooting](https://docs.paymongo.com/docs/payment-acceptance-troubleshooting.md): Troubleshooting common issues across payment methods and features — symptoms, likely causes, and how to resolve them. Covers failed payments, webhook delivery issues, redirect problems, and deep link errors. - [Testing](https://docs.paymongo.com/docs/payment-acceptance-testing.md): How test mode works, test API keys, and test cases for all payment methods and features. - [Go-live checklist](https://docs.paymongo.com/docs/payment-acceptance-go-live-checklist.md): Ready your Payment Intent and Payment Methods API integration. Covers per-method tests, refunds, disputes, security, and the live mode smoke test. - [Introduction](https://docs.paymongo.com/docs/payment-channels-introduction.md): Accept payments without building your own checkout UI. Choose from hosted checkout, payment links, payment pages, e-commerce plugins, and Storefront. - [Key concepts](https://docs.paymongo.com/docs/payment-channels-key-concepts.md) - [Use cases](https://docs.paymongo.com/docs/payment-channels-use-cases.md) - [Hosted Checkout](https://docs.paymongo.com/docs/payment-channels-hosted-checkout.md): Accept payments through a PayMongo-hosted page by creating a Checkout Session from your backend. - [Quick start](https://docs.paymongo.com/docs/payment-channels-hosted-checkout-quick-start.md): Create your first Checkout Session, redirect the customer, and confirm payment via webhook. - [Payment Links](https://docs.paymongo.com/docs/payment-channels-payment-links.md): Learn what PayMongo Payment Links are, when to use them instead of Payment Pages, and how to create, share, track, or manage payment links through the API. - [Payment Pages](https://docs.paymongo.com/docs/payment-channels-payment-pages.md): Learn what PayMongo Payment Pages are, when to use them instead of Payment Links, and how to create, customize, share, and track a reusable payment page from your dashboard. - [Storefront](https://docs.paymongo.com/docs/payment-channels-storefront.md): Learn what PayMongo Storefront is, what it can do in beta, how it differs from Payment Pages, and how to build your store from the dashboard. - [Order & Pay](https://docs.paymongo.com/docs/payment-channels-order-and-pay.md): Set up ordering and payment flows for products and services, including F&B, hotels, bookings, ticketing, and other use cases. - [Setup](https://docs.paymongo.com/docs/payment-channels-order-and-pay-setup.md): Set up Order & Pay by creating a Location, Catalog, and Touchpoints, then share branded QR codes or URLs. This example walks through a food & beverage setup — the same steps apply to other use cases like hotels, bookings, or ticketing. - [Ordering Steps](https://docs.paymongo.com/docs/payment-channels-order-and-pay-ordering-steps.md): Guide customers from Order Web to payment while managing order fulfillment in Order & Pay. - [Invoices](https://docs.paymongo.com/docs/payment-channels-invoices.md) - [Create and Send an Invoice](https://docs.paymongo.com/docs/payment-channels-invoices-create-and-send.md): Fill in the customer and line items, customize the look, preview, then email it or share the link. - [Reminders](https://docs.paymongo.com/docs/payment-channels-invoices-reminders.md): PayMongo follows up automatically on unpaid invoices, and you can nudge a customer any time. - [Import Invoices in Bulk](https://docs.paymongo.com/docs/payment-channels-invoices-bulk-import.md): Create up to 1,000 invoices from a CSV, with column matching and a review step. - [Invoice Approvals](https://docs.paymongo.com/docs/payment-channels-invoices-approvals.md): Require a different team member to approve an invoice before it is sent. - [Manage Sent Invoices](https://docs.paymongo.com/docs/payment-channels-invoices-manage.md): Track payment, void an invoice, download PDFs, export your list, and control who has access. - [Repeating Invoices](https://docs.paymongo.com/docs/payment-channels-invoices-repeating.md): Bill the same customer on a schedule, without touching it each cycle. - [E-commerce Plugins](https://docs.paymongo.com/docs/payment-channels-e-commerce-plugins.md): Add PayMongo to Shopify, WooCommerce, Magento, or PrestaShop without writing code. Compare features and pick the right plugin for your store. - [Shopify](https://docs.paymongo.com/docs/payment-channels-e-commerce-plugins-shopify.md): Install PayMongo on Shopify to accept payments. Choose between Secure Payments, Express Cards, and Credit/Debit Card. - [Secure Payments on Shopify](https://docs.paymongo.com/docs/payment-channels-e-commerce-plugins-shopify-secure-payments.md): Secure Payments via PayMongo lets you accept cards, e-wallets, online banking, and BNPL on Shopify through a PayMongo-hosted checkout page. - [Hold then Capture on Shopify](https://docs.paymongo.com/docs/payment-channels-e-commerce-plugins-shopify-hold-then-capture.md) - [Express Cards on Shopify](https://docs.paymongo.com/docs/payment-channels-e-commerce-plugins-shopify-express-cards.md) - [WooCommerce](https://docs.paymongo.com/docs/payment-channels-ecommerce-plugins-woocommerce.md): Use the PayMongo Hosted Checkout Plugin for WooCommerce to accept cards, e-wallets, and direct online banking through PayMongo — all through a single plugin installation. - [Legacy WooCommerce Plugin](https://docs.paymongo.com/docs/payment-channels-ecommerce-plugins-legacy-woocommerce.md): Use the PayMongo WooCommerce plugin to accept cards, e-wallets, and direct online banking through PayMongo on your WordPress store. - [Magento](https://docs.paymongo.com/docs/payment-channels-ecommerce-plugin-magento.md): Use the PayMongo Magento module to accept cards, e-wallets, BillEase, and BPI on your Magento store through PayMongo's developer partner module. - [Supporting Tools](https://docs.paymongo.com/docs/payment-channels-supporting-tools.md): Explore tools that help you manage payment activity and operations across your Payment Channels. - [Customers](https://docs.paymongo.com/docs/payment-channels-supporting-tools-customers.md): Reconcile customer orders and review payment activity across payment channels from one place. - [Products](https://docs.paymongo.com/docs/payment-channels-supporting-tools-products.md): Manage your merchant product catalog and reuse products across supported PayMongo Payment Channels. - [Best practices](https://docs.paymongo.com/docs/payment-channels-best-practices.md) - [Troubleshooting](https://docs.paymongo.com/docs/payment-channels-troubleshooting.md) - [Testing](https://docs.paymongo.com/docs/payment-channels-testing.md) - [Go-live checklist](https://docs.paymongo.com/docs/payment-channels-go-live-checklist.md): Prepare the customer-facing surface that collects payments. Covers Hosted Checkout, Payment Links, Payment Pages, Storefront, and e-commerce plugins. - [Introduction](https://docs.paymongo.com/docs/money-movement-introduction.md): How funds flow on PayMongo — from accepted payment to wallet, and from wallet to payout or disbursement. - [Key concepts](https://docs.paymongo.com/docs/money-movement-key-concepts.md): The mental model, vocabulary, and lifecycle behind every wallet, and transfer on PayMongo. - [Use cases](https://docs.paymongo.com/docs/money-movement-use-cases.md): Real-world examples of how businesses move money using PayMongo. Find the pattern closest to yours - [Quick start](https://docs.paymongo.com/docs/money-movement-quick-start.md): Send your first disbursement on PayMongo. Pick the path that matches how you work — the outcome is the same: funds delivered from your wallet to a recipient account, with a status you can verify - [Move money with API](https://docs.paymongo.com/docs/money-movement-moving-money-with-api.md): Send your first transfer in five steps, from finding your wallet to seeing the status update. - [Move money using your Paymongo Dashboard](https://docs.paymongo.com/docs/money-movement-moving-money-using-your-paymongo-dashboard.md): Send your first disbursement on PayMongo without writing any code. This guide walks through the live dashboard, but the same flow works in test mode — switch the mode toggle in the header to send a sandboxed transfer first. - [Move money with Wallet QR](https://docs.paymongo.com/docs/money-movement-moving-money-with-wallet-qr.md): Generate a QR to receive funds into your wallet, or scan one to push funds out — in four steps. - [Wallets](https://docs.paymongo.com/docs/money-movement-wallets.md): A PayMongo Wallet holds your funds on the platform. Receive payment settlements automatically, top up and send money to any bank or e-wallet — all from one account. - [Manage your balance](https://docs.paymongo.com/docs/money-movement-manage-your-balance.md): Know exactly what's spendable, with two reliable ways to keep the wallet funded for outbound moves. - [Send money](https://docs.paymongo.com/docs/money-movement-send-money.md): Money out of your Wallet to one recipient or many, in real-time or by the next banking day, from the Dashboard or your code. - [Lock your wallet](https://docs.paymongo.com/docs/money-movement-lock-your-wallet.md): Turn your PayMongo Wallet off in one verified step to stop all money movement, and turn it back on whenever you're ready. - [Wallet QR](https://docs.paymongo.com/docs/money-movement-wallet-qr.md): Use a QR code to receive money into your PayMongo Wallet or send money out — no account number required. - [Payouts](https://docs.paymongo.com/docs/money-movement-payouts.md): Receive your payouts to a wallet or bank account, automatically and on the schedule you choose. - [Reconciliation](https://docs.paymongo.com/docs/money-movement-payouts-reconciliation.md): PayMongo provides built-in tools to help you reconcile your payout records directly from the merchant dashboard. This page walks through how to use the Payout History and export features for your reconciliation workflow. - [Instant Settlement](https://docs.paymongo.com/docs/money-movement-instant-settlement.md): Get paid the moment a transaction is completed — no clearing periods, no waiting. Learn how to enable Instant Settlement for your account. - [Bank Configuration](https://docs.paymongo.com/docs/money-movement-bank-configuration.md) - [List of Banks](https://docs.paymongo.com/docs/money-movement-list-of-banks.md): A reference list of banks supported for PESONet and InstaPay transfers. - [Disbursements](https://docs.paymongo.com/docs/money-movement-disbursements.md): Money to your recipients' accounts, one transfer or a thousand at once, in real-time or by the next banking day. - [Reconciliation](https://docs.paymongo.com/docs/money-movement-disbursements-reconciliation.md) - [Error Codes](https://docs.paymongo.com/docs/money-movement-error-codes.md) - [Forex](https://docs.paymongo.com/docs/money-movement-forex.md): Lock in a price for converting between the Philippine Peso and supported foreign currencies, and settle against that price from anywhere in the PayMongo platform. - [Expense Management](https://docs.paymongo.com/docs/expense-management.md): Submit, approve, pay, and track employee expense reimbursement requests in one place. - [Set up Expense Management](https://docs.paymongo.com/docs/set-up-expense-management.md): Choose expense types, budget codes, payment source, and approval rules before your team submits requests. - [Submit an expense request](https://docs.paymongo.com/docs/submit-an-expense-request.md): Create a reimbursement request from a receipt photo or by entering the expense details yourself. - [Review and track expense requests](https://docs.paymongo.com/docs/review-and-track-expense-requests.md): Follow each request through approval, payment, and completion from the PayMongo Dashboard. - [Set up Expense Management with the API](https://docs.paymongo.com/docs/set-up-expense-management-with-the-api.md): Configure merchant settings, approval workflows, and rules, then submit a test expense with the API. - [Test your Expense Management setup](https://docs.paymongo.com/docs/test-your-expense-management-setup.md): Check your expense form, approval rules, approvers, and transfers before using real company funds. - [Transfer Approvals](https://docs.paymongo.com/docs/transfer-approvals.md): Require designated approvers to review and approve every transfer before PayMongo processes it. - [Set up Transfer Approvals](https://docs.paymongo.com/docs/set-up-transfer-approvals.md): Create an approval template and enable transfer approvals from the Dashboard. - [Review Transfer Approval Requests](https://docs.paymongo.com/docs/review-transfer-approval-requests.md): Approve or deny pending transfer requests from the Requests & Approvals dashboard. - [Test your Transfer Approvals setup](https://docs.paymongo.com/docs/test-your-transfer-approvals-setup.md): Verify that your transfer approval flow works correctly before going live. - [Best practices](https://docs.paymongo.com/docs/money-movement-best-practices.md): A short guide to integrating the Transfers and Wallets APIs in a way that survives retries and stays easy to reconcile. - [Transfer Test Cases](https://docs.paymongo.com/docs/transfer-test-cases.md) - [Go-live checklist](https://docs.paymongo.com/docs/money-movement-go-live-checklist.md): Set up how funds leave PayMongo. Covers Payouts, Wallet, and Disbursements through InstaPay or PESONet. - [Issuing](https://docs.paymongo.com/docs/issuing.md) - [Introduction](https://docs.paymongo.com/docs/financial-services-introduction.md) - [Key concepts](https://docs.paymongo.com/docs/financial-services-key-concepts.md) - [Use cases](https://docs.paymongo.com/docs/financial-services-use-cases.md) - [Quick start](https://docs.paymongo.com/docs/financial-services-quick-start.md): The fastest path to getting started with PayMongo Capital — applying for Capital as a merchant, or creating your first offer as a lender. - [Capital](https://docs.paymongo.com/docs/financial-services-capital.md) - [Become a lender](https://docs.paymongo.com/docs/financial-services-capital-become-a-lender.md) - [Data Access & Monitoring](https://docs.paymongo.com/docs/financial-services-capital-eligibility-check.md) - [Loan offer](https://docs.paymongo.com/docs/financial-services-capital-loan-offers.md) - [Create a loan offer](https://docs.paymongo.com/docs/financial-services-create-a-loan-offer.md) - [Deleting an offer](https://docs.paymongo.com/docs/financial-services-deleting-an-offer.md) - [Inviting accounts to an offer](https://docs.paymongo.com/docs/financial-services-inviting-accounts-to-an-offer.md) - [Deleting account invitation from an offer](https://docs.paymongo.com/docs/financial-services-deleting-account-invitation.md): How to revoke a Capital loan offer invitation from a merchant account, including when to delete one and the effect on in-progress applications. - [Review loan application](https://docs.paymongo.com/docs/financial-services-review-loan-application.md) - [Update loan application requirement](https://docs.paymongo.com/docs/financial-services-update-loan-application-requirement.md) - [Contract and Loan](https://docs.paymongo.com/docs/financial-services-contract-and-loan.md): How to retrieve and track your lender contracts and their associated loans using the PayMongo Capital API. - [Repayment](https://docs.paymongo.com/docs/financial-services-capital-repayment.md) - [Testing](https://docs.paymongo.com/docs/financial-services-capital-testing.md) - [Best practices](https://docs.paymongo.com/docs/financial-services-best-practices.md) - [Troubleshooting](https://docs.paymongo.com/docs/financial-services-troubleshooting.md) - [Introduction](https://docs.paymongo.com/docs/security-analytics-introduction.md): An overview of the Security & Analytics section — what it covers, who each product is for, and where to start. - [Protect](https://docs.paymongo.com/docs/security-analytics-protect.md): Learn what PayMongo Protect covers and choose the right page for fraud rules, reviews, blocked transactions, and scores. - [Key concepts](https://docs.paymongo.com/docs/security-analytics-protect-key-concepts.md): Foundational concepts for Protect — risk scores, fraud rules, the review queue, blocked list, and key terms. - [Use cases](https://docs.paymongo.com/docs/security-analytics-protect-use-cases.md): Real-world examples of how businesses use Protect to prevent fraud, reduce chargebacks, and manage risk. - [Quick start](https://docs.paymongo.com/docs/security-analytics-protect-quick-start.md): The fastest path to enabling Protect, setting your first rule, and reviewing your first flagged transaction. - [Reviews](https://docs.paymongo.com/docs/security-analytics-protect-reviews.md): How to investigate and manage transactions flagged for manual review in PayMongo Protect. - [Blocked list](https://docs.paymongo.com/docs/security-analytics-protect-blocked-list.md): How to monitor and manage transactions automatically declined by your Protect block rules. - [Rules](https://docs.paymongo.com/docs/security-analytics-protect-rules.md): How to create custom fraud rules that trigger on specific conditions — rule logic, attributes, and how to test rules before publishing. - [Scores](https://docs.paymongo.com/docs/security-analytics-protect-scores.md): How PayMongo assigns a risk score to each transaction, what factors influence it, and how to use scores to calibrate your rules. - [Best Practices](https://docs.paymongo.com/docs/protect-best-practices.md): How to get the most out of PayMongo Protect — from writing effective rules to managing your review queue and calibrating risk thresholds - [Analytics](https://docs.paymongo.com/docs/security-analytics-analytics.md): Learn what Analytics covers and choose between dashboard analytics and Prism. - [Key concepts](https://docs.paymongo.com/docs/security-analytics-analytics-key-concepts.md): Learn how PayMongo structures analytics data and how dashboard analytics differs from Prism. - [Use cases](https://docs.paymongo.com/docs/security-analytics-analytics-use-cases.md): See common Analytics workflows for dashboard reporting and custom Prism reporting. - [Quick start](https://docs.paymongo.com/docs/security-analytics-analytics-quick-start.md): Get from dashboard analytics to your first Prism query in a few steps. - [Dashboard analytics](https://docs.paymongo.com/docs/security-analytics-dashboard-analytics.md): Use dashboard analytics to review revenue trends, transaction breakdowns, and pre-built reports without SQL. - [Prism](https://docs.paymongo.com/docs/security-analytics-prism.md): Use Prism to write SQL queries, run custom reports, and schedule exports from PayMongo data. - [Best Practices](https://docs.paymongo.com/docs/analytics-best-practices.md): How to get the most out of Prism — from writing efficient queries to managing scheduled exports and keeping your reports accurate and reliable - [Troubleshooting](https://docs.paymongo.com/docs/security-analytics-troubleshooting.md): Common issues with Protect, Policies, and Analytics — rules not triggering, incorrect risk scores, missing transaction data, and how to resolve them. - [Introduction](https://docs.paymongo.com/docs/account-settings-introduction.md): Get oriented to PayMongo's Account & Settings — account setup, capabilities, team management, security, billing, and troubleshooting. - [Key concepts](https://docs.paymongo.com/docs/account-settings-key-concepts.md): The mental model for organizations, activation, wallets, identity verification, roles, API keys, and child accounts on PayMongo. - [Account setup](https://docs.paymongo.com/docs/account-settings-account-setup.md): Create and activate a PayMongo account — sign-up, agreements, identity verification, business profile, and document requirements by entity type. - [Verification requirements](https://docs.paymongo.com/docs/account-settings-verification-requirements.md): Consolidated account verification requirements for KYC, entity documents, payout setup, website checks, and foreign document authentication. - [KYC – Accepted IDs](https://docs.paymongo.com/docs/account-settings-kyc-accepted-ids.md): Valid government-issued IDs accepted for PayMongo's KYC verification process. - [Philippine Entities](https://docs.paymongo.com/docs/account-settings-philippine-entities.md): Document requirements for businesses registered in the Philippines — sole proprietorship, partnership, corporation, and OPC. - [Government Entities](https://docs.paymongo.com/docs/account-settings-government-entities.md): Document requirements for government entities — LGUs, state universities and colleges, and GOCCs or GFIs. - [Non-Philippine Entities](https://docs.paymongo.com/docs/account-settings-non-philippine-entities.md): Document requirements for businesses registered outside the Philippines onboarding with PayMongo. - [Enhanced Due Diligence](https://docs.paymongo.com/docs/account-settings-enhanced-due-diligence.md): Additional verification checks applied to higher-risk business profiles during onboarding. - [Website Guidelines](https://docs.paymongo.com/docs/account-settings-website-guidelines.md): Online presence requirements to meet when you onboard with PayMongo. - [Authorized Representative](https://docs.paymongo.com/docs/account-settings-authorized-representative.md): Who can transact on behalf of your business and how to update representative details. - [Foreign Document Authentication](https://docs.paymongo.com/docs/account-settings-foreign-document-authentication.md): How to authenticate foreign corporate documents via apostille, consularization, or alternative paths. - [Business Types](https://docs.paymongo.com/docs/account-settings-business-types.md) - [Taxes](https://docs.paymongo.com/docs/account-settings-taxes.md): Learn how tax regulations apply to your account based on how you use our platform. - [Account capabilities](https://docs.paymongo.com/docs/account-settings-account-capabilities.md): Understand the capabilities available on your PayMongo account (payment methods, wallet, subscriptions, capital, and linked accounts) and how to activate each. - [Dashboard navigation](https://docs.paymongo.com/docs/account-settings-dashboard-navigation.md): What you see when you log in to the PayMongo Dashboard, and where each tab in the left navigation takes you. - [Team & roles](https://docs.paymongo.com/docs/account-settings-team-roles.md): Manage team access on your PayMongo account — invite members, assign roles, and control permissions - [Managing team members](https://docs.paymongo.com/docs/account-settings-managing-team-members.md): Step-by-step guide to inviting, editing, and removing team members on your PayMongo account - [Roles & permissions](https://docs.paymongo.com/docs/account-settings-roles-permissions.md): Complete reference of every PayMongo role and its permissions — what each role can do and which to assign to your team. - [Security](https://docs.paymongo.com/docs/account-settings-security.md): Protect your PayMongo account with API key management, multi-factor authentication, and security logs. - [API keys](https://docs.paymongo.com/docs/account-settings-api-keys.md): Generate, rotate, and revoke API keys — and best practices for keeping credentials secure across test and live environments. - [Multi-factor authentication](https://docs.paymongo.com/docs/account-settings-multi-factor-authentication.md): Verify yourself with an emailed one-time password or an authenticator app (TOTP) when logging in and on sensitive actions - [Security logs](https://docs.paymongo.com/docs/account-settings-security-logs.md): Audit trail of login events, API key access, profile changes, and other sensitive actions on your PayMongo account. - [Linked accounts](https://docs.paymongo.com/docs/account-settings-linked-accounts.md): Link PayMongo accounts in a parent / child relationship to invite, onboard, and operate on other accounts through the Accounts API. - [Linked Transactions ](https://docs.paymongo.com/docs/account-settings-linked-transactions.md): Learn how to send API requests to perform actions on behalf of your child accounts. - [Troubleshooting](https://docs.paymongo.com/docs/account-settings-troubleshooting.md): Common issues with account setup, verification, team management, and billing — symptoms, likely causes, and how to resolve them. - [Customer Support](https://docs.paymongo.com/docs/account-settings-customer-support.md): Reach out to the team for needed support and track all updates regarding your inquiries through your PayMongo Dashboard. - [Reach the Team](https://docs.paymongo.com/docs/account-settings-reach-the-team.md): Reach out to the Customer Success team via the dedicated chat widget located on the PayMongo Dashboard. - [Track Ticket Status](https://docs.paymongo.com/docs/account-settings-track-ticket-status.md): Track all ticket activity, from reachouts, follow-ups, and updates, through the PayMongo dashboard. - [Appendix](https://docs.paymongo.com/docs/account-settings-appendix.md) - [List of available banks](https://docs.paymongo.com/docs/account-settings-available-banks.md) - [List of valid states](https://docs.paymongo.com/docs/account-settings-valid-states.md) - [List of available industry](https://docs.paymongo.com/docs/account-settings-available-industry.md) - [List of available intended products](https://docs.paymongo.com/docs/account-settings-available-intended-products.md) - [List of file record purpose](https://docs.paymongo.com/docs/account-settings-file-record-purpose.md) - [List of valid nature of work](https://docs.paymongo.com/docs/account-settings-nature-of-work.md) - [List of valid source of funds](https://docs.paymongo.com/docs/account-settings-source-of-funds.md) - [List of estimated monthly volume](https://docs.paymongo.com/docs/account-settings-estimated-monthly-volume.md) - [List of nationalities](https://docs.paymongo.com/docs/account-settings-nationalities.md) - [List of business age](https://docs.paymongo.com/docs/account-settings-business-age.md) - [List of business sizes](https://docs.paymongo.com/docs/account-settings-business-sizes.md) - [List of merchant category codes](https://docs.paymongo.com/docs/account-settings-merchant-category-codes.md) - [Introduction](https://docs.paymongo.com/docs/developer-tools-introduction.md): Everything you need to build, test, and monitor your PayMongo integration. - [Webhooks](https://docs.paymongo.com/docs/developer-tools-webhooks.md): Get notified the moment an event happens — no polling required. - [Key Concepts](https://docs.paymongo.com/docs/developer-tools-webhooks-key-concepts.md) - [Setup & Management](https://docs.paymongo.com/docs/developer-tools-webhook-setup-management.md) - [Creating a Webhook Endpoint](https://docs.paymongo.com/docs/creating-a-webhook-endpoint.md): Learn how to register webhook endpoints in PayMongo to receive real-time event notifications for your integration. - [Updating Webhook Endpoints](https://docs.paymongo.com/docs/updating-webhook-endpoints.md) - [Disabling a Webhook Endpoint](https://docs.paymongo.com/docs/disabling-a-webhook-endpoint.md) - [Re-enabling a Webhook Endpoint](https://docs.paymongo.com/docs/re-enabling-a-webhook-endpoint.md) - [Retry a Webhook Delivery](https://docs.paymongo.com/docs/retry-a-webhook-delivery.md) - [Webhook Testing](https://docs.paymongo.com/docs/webhook-testing.md): Test webhooks before diving in to live dispatch - [Events](https://docs.paymongo.com/docs/developer-tools-webhooks-events.md) - [Onboarding webhooks](https://docs.paymongo.com/docs/developer-tools-onboarding-webhooks.md): Wire up a webhook handler that responds correctly to every event emitted during a child account's onboarding. - [Capability request webhooks](https://docs.paymongo.com/docs/developer-tools-capability-request-webhooks.md): Every API call that moves a capability request, the event it emits, and the payload your handler receives. - [Retry Logic](https://docs.paymongo.com/docs/developer-tools-retry-logic.md) - [Best Practices](https://docs.paymongo.com/docs/developer-tools-best-practices.md) - [Dashboard Module](https://docs.paymongo.com/docs/developer-tools-dashboard-module.md): Learn about how you can manage your webhook integrations via your PayMongo Dashboard - [Access & Navigation](https://docs.paymongo.com/docs/developer-tools-dashboard-module-access-and-navigation.md): Access and navigate the Webhooks Module in your PayMongo Dashboard - [Create a Webhook](https://docs.paymongo.com/docs/developer-tools-dashboard-module-create-a-webhook.md): Create a new webhook and subscribe to events from the PayMongo Dashboard - [Update a Webhook](https://docs.paymongo.com/docs/developer-tools-dashboard-module-update-a-webhook.md): Learn how to update an existing webhook with your preferred specifications - [Disable a Webhook](https://docs.paymongo.com/docs/developer-tools-dashboard-module-disable-a-webhook.md): Learn how to disable an existing webhook through your Webhooks Module - [Enable a Webhook](https://docs.paymongo.com/docs/developer-tools-dashboard-module-enable-a-webhook.md): Re-enable a disabled webhook to resume receiving events from the PayMongo Dashboard - [Retry a Webhook Event](https://docs.paymongo.com/docs/developer-tools-dashboard-module-resend-a-webhook-event.md): Retry a failed or unprocessed webhook event delivery from the PayMongo Dashboard - [Sending a Test Event](https://docs.paymongo.com/docs/sending-a-test-event.md): Send a test event to a webhook of your choice - [MCP Server](https://docs.paymongo.com/docs/mcp-server.md) - [Key Concepts](https://docs.paymongo.com/docs/developer-tools-mcp-key-concepts.md) - [Use Cases](https://docs.paymongo.com/docs/developer-tools-mcp-use-cases.md) - [Quick Start](https://docs.paymongo.com/docs/developer-tools-mcp-quick-start.md) - [Error Handling](https://docs.paymongo.com/docs/developer-tools-error-handling.md) - [Best Practices](https://docs.paymongo.com/docs/developer-tools-best-practices-1.md) - [Troubleshooting](https://docs.paymongo.com/docs/developer-tools-troubleshooting.md) - [Testing](https://docs.paymongo.com/docs/developer-tools-testing.md) - [Go-live checklist](https://docs.paymongo.com/docs/developer-tools-go-live-checklist.md): Lock down API key handling and webhook setup before going live. Covers authentication, idempotency, signature verification, and event handling. - [Introduction](https://docs.paymongo.com/docs/fiaas-introduction.md): Understand what Fintech Infrastructure is, which building blocks it gives your business, and where to start assembling them. - [Use cases](https://docs.paymongo.com/docs/fiaas-use-cases.md): Recognize whether your product is one of the platform shapes Fintech Infrastructure is built for, and see which building blocks each shape assembles. - [Key concepts](https://docs.paymongo.com/docs/fiaas-key-concepts.md): Walk away with the mental model behind Fintech Infrastructure — building blocks, Linked Accounts, and the terms every sub-section uses. - [Onboarding-as-a-Service](https://docs.paymongo.com/docs/onboarding-as-a-service.md): Understand what Onboarding-as-a-Service unlocks for your platform and how to get started building with it. - [Use cases](https://docs.paymongo.com/docs/onboarding-aas-use-cases.md): Recognize whether Onboarding-as-a-Service fits your platform by comparing your shape to how marketplaces, travel and booking platforms, SaaS, logistics, employee disbursement, payment aggregators, and referral platforms use it. - [Key concepts](https://docs.paymongo.com/docs/onboarding-aas-key-concepts.md): Walk away with a clear mental model of parent and child accounts, the lifecycle, and the terms you will use throughout this section. - [Onboarding paths](https://docs.paymongo.com/docs/onboarding-aas-onboarding-paths.md): Decide whether to invite an account holder or create the account directly, before you start integrating. - [Quick start](https://docs.paymongo.com/docs/onboarding-aas-quick-start.md): Onboard your first working child account end-to-end and confirm activation through a webhook. - [Capability requests API](https://docs.paymongo.com/docs/onboarding-aas-capability-requests.md): Open, move, and track a capability request over the API — the endpoints, the product codes, and what a parent platform can do today. - [Opt-in features](https://docs.paymongo.com/docs/onboarding-aas-opt-in-features.md): See which opt-in features exist, whether your platform qualifies, and how to request access. - [Auto-configuration](https://docs.paymongo.com/docs/onboarding-aas-auto-configuration.md): Have every new child account activated with your standard capability set, without per-account requests. - [Account capabilities](https://docs.paymongo.com/docs/onboarding-aas-account-capabilities.md): Know which capabilities a child account starts with at activation, and how you will extend them when capability management for linked accounts ships. - [Disable dashboard access](https://docs.paymongo.com/docs/onboarding-aas-disable-dashboard-access.md): Disable PayMongo Dashboard access for your child accounts to keep the recipient experience fully white-labeled. - [Best practices](https://docs.paymongo.com/docs/onboarding-aas-best-practices.md): Find the right tips and FAQs for the onboarding stage you are working on right now. - [Best practices — Creation](https://docs.paymongo.com/docs/onboarding-aas-bp-creation.md): Create child accounts cleanly the first time and avoid the most common early-stage mistakes. - [Best practices — Identity verification](https://docs.paymongo.com/docs/onboarding-aas-bp-identity-verification.md): Run identity verification with higher pass rates and a clear retry path when an attempt fails. - [Best practices — Updating](https://docs.paymongo.com/docs/onboarding-aas-bp-updating.md): Fill in account details without losing user progress to enum or validation errors. - [Best practices — Activation](https://docs.paymongo.com/docs/onboarding-aas-bp-activation.md): Activate child accounts reliably and know exactly what to do when an activation is declined. - [Best practices — Webhooks](https://docs.paymongo.com/docs/onboarding-aas-bp-webhooks.md): Receive and process every onboarding and child-account event reliably and securely. - [Testing](https://docs.paymongo.com/docs/onboarding-aas-testing.md): Validate your integration end-to-end in sandbox so you can switch to live with confidence. - [Troubleshooting](https://docs.paymongo.com/docs/onboarding-aas-troubleshooting.md): Diagnose and recover from any failure in the onboarding flow without guessing. - [Appendix](https://docs.paymongo.com/docs/onboarding-aas-appendix.md): Look up the exact accepted values for every Accounts API field that expects an enum. - [Ledgers-aaS](https://docs.paymongo.com/docs/fintech-infrastructure-ledgers-aas.md): PayMongo's ledger infrastructure for tracking balances, transactions, and entries with double-entry accuracy. - [Key Concepts](https://docs.paymongo.com/docs/fintech-infrastructure-ledgers-aas-key-concepts.md): Foundational concepts, terminology, and the double-entry model behind every Ledgers-aaS operation. - [Use Cases](https://docs.paymongo.com/docs/fintech-infrastructure-ledgers-aas-use-cases.md): Real-world scenarios where Ledgers-aaS is the right primitive for tracking balances and money movement. - [Quick Start](https://docs.paymongo.com/docs/fintech-infrastructure-ledgers-aas-quick-start.md): The fastest path from authentication to a first posted ledger transaction. - [Workflows-aaS](https://docs.paymongo.com/docs/fiaas-workflows.md): PayMongo Workflow is an automation tool for customizing and automating money movement across PayMongo wallets and bank accounts. - [Key Concepts](https://docs.paymongo.com/docs/fiaas-workflows-core-concepts.md): Learn the key Workflow API concepts: how workflows run, how variables resolve, and how validation errors are returned. - [How A Workflow Runs](https://docs.paymongo.com/docs/fiaas-workflows-how-a-workflow-runs.md): Understand workflow instances, step execution, statuses, retries, timeouts, and livemode isolation. - [Validation and Errors](https://docs.paymongo.com/docs/fiaas-workflows-validation-and-errors.md): Understand when workflow validation runs, how error envelopes are structured, and how to troubleshoot field-level errors. - [Variables and Expressions](https://docs.paymongo.com/docs/fiaas-workflows-variables-and-expressions.md): Use variables and expressions to reference workflow input, earlier step outputs, and computed values at runtime. - [Workflow Definitions](https://docs.paymongo.com/docs/fiaas-workflows-defining-a-workflow.md): Reference the Workflow API schema for top-level keys, step shape, action keys, and runtime variables. - [Send Money Step](https://docs.paymongo.com/docs/fiaas-workflows-send-money-step.md): Step for Sending Money to PayMongo Wallet or Bank Account. - [Compute Step](https://docs.paymongo.com/docs/fiaas-workflows-compute.md): Use the compute step to evaluate expressions, calculate derived amounts, and expose named outputs for downstream workflow steps. - [Get Wallet Balance Step](https://docs.paymongo.com/docs/fiaas-workflows-get-wallet-balance-step.md): Use the get_wallet_balance step to read a PayMongo wallet’s available and pending balances for downstream workflow decisions. - [Wait Event Step](https://docs.paymongo.com/docs/fiaas-workflows-wait-event-step.md): Use the wait_event step to pause a workflow until a matching external event arrives, then resume with the submitted payload. This feature is currently in Beta. - [Triggering Workflows](https://docs.paymongo.com/docs/fiaas-workflows-triggering-workflows.md): Create triggers that start workflows from PayMongo events or cron-based schedules, and understand trigger states. - [Event-Based Triggers](https://docs.paymongo.com/docs/fiaas-workflows-event-based-triggers.md): Use event-based triggers to start workflows when matching PayMongo events are published. - [Schedule-Based Triggers](https://docs.paymongo.com/docs/fiaas-workflows-schedule-based-triggers.md): Use schedule-based triggers to run workflows on cron schedules, predefined macros, or interval-based recurrence. - [Use Cases](https://docs.paymongo.com/docs/fiaas-workflows-use-cases.md): Explore Workflow API use cases for payout redirection, scheduled transfers, split payouts, wallet sweeps, wallet top-ups, and confirmation-based payout holds. - [Schedule a Money Transfer from your Paymongo Wallet](https://docs.paymongo.com/docs/fiaas-workflows-schedule-a-money-transfer-from-your-paymongo-wallet.md): This guide shows how to schedule a money transfer from your PayMongo Wallet using a cron-based Workflow trigger. - [Automatically Direct Payouts to Other Destinations](https://docs.paymongo.com/docs/fiaas-workflows-automatically-automatically-direct-payouts-to-bank-account-or-other-paymongo-wallet.md): This guide shows how to redirect payouts from a PayMongo Wallet to a bank account or another PayMongo Wallet using Workflow. - [Split A Payout](https://docs.paymongo.com/docs/fiaas-workflows-split-a-payout.md): Split a payout into exact shares with compute helpers, then send each share through separate send_money steps. - [Sweeps Wallet On A Schedule](https://docs.paymongo.com/docs/fiaas-workflows-sweeps-wallet-on-a-schedule.md): Schedule wallet sweeps that keep a reserve balance, calculate the sweep amount, and transfer funds to a bank account or parent wallet. - [Top Up A Wallet On Low Balance](https://docs.paymongo.com/docs/fiaas-workflows-top-up-a-wallet-on-low-balance.md): Schedule wallet top-ups that check a target wallet balance and fund the gap from another wallet when balance is low. - [Hold A Payout Until Confirmed](https://docs.paymongo.com/docs/fiaas-workflows-hold-a-payout-until-confirmed.md): Hold merchant payout funds in escrow until a confirmation event arrives, then release the merchant share with a wait_event step. - [Authentication](https://docs.paymongo.com/docs/fiaas-workflows-authentication.md): Authenticate Workflow API requests with HTTP Basic using your PayMongo secret key and the required Organization-Id header. - [Observing Workflow Runs](https://docs.paymongo.com/docs/fiaas-workflows-observing-workflow-runs.md): Inspect workflow instances, step history, wait states, and common run states using Workflow API read endpoints. - [Quickstart](https://docs.paymongo.com/docs/fiaas-workflows-quickstart.md): Create your first Workflow API workflow, attach a schedule trigger, inspect the run, and clean up the trigger. ## API Reference - [Idempotent requests](https://docs.paymongo.com/reference/idempotent-requests.md) - [Payment Intent Resource](https://docs.paymongo.com/reference/the-payment-intent-object.md) - [Create a Payment Intent](https://docs.paymongo.com/reference/create-a-paymentintent.md): Use secret API key to create a Payment Intent - [Attach to Payment Intent](https://docs.paymongo.com/reference/attach-to-paymentintent.md) - [Payment Method Resource](https://docs.paymongo.com/reference/the-payment-method-object.md) - [Create a Payment Method](https://docs.paymongo.com/reference/create-a-paymentmethod.md): Use public API key or secret API key to create a Payment Method - [List all Payments](https://docs.paymongo.com/reference/list-all-payments.md): Use secret API key to retrieve a list of Payments. - [Retrieve a Customer](https://docs.paymongo.com/reference/retrieve-customer.md): Use a secret API key to retrieve a Customer. - [Generate an MPM QR](https://docs.paymongo.com/reference/generate-mpm-qr.md): Generate a Merchant Presenter Mode QR - [Execute an MPM QR](https://docs.paymongo.com/reference/execute-mpm-qr.md): Initiate a transaction from the scanner to the beneficiary account designated in the QR - [Retrieve a QR](https://docs.paymongo.com/reference/retrieve-a-qr.md): Get the details of a QR - [Expire/Disable a QR](https://docs.paymongo.com/reference/expiredisable-a-qr.md): Expire a dynamic QR or disable a static QR - [Create a static QR Ph code](https://docs.paymongo.com/reference/create-a-static-qr-ph-code.md): Use the secret API key to create a static QR Ph code - [List all Installment Plans](https://docs.paymongo.com/reference/list-installment-plans.md) - [Subscriptions](https://docs.paymongo.com/reference/subscription-1.md) - [Subscription Resource](https://docs.paymongo.com/reference/subscription-resource.md): With Subscriptions, customers make recurring payments for access to a product. Subscriptions require you to retain more information about your customers than one-time purchases because you need to charge them in the future. - [Create a Subscription](https://docs.paymongo.com/reference/create-a-subscription.md): Use secret API key to create a Subscription. - [Create an On-Demand Payment Subscription](https://docs.paymongo.com/reference/initiate-on-demand-payment.md): Use secret API key to initiate an on-demand payment - [Retrieve a Subscription](https://docs.paymongo.com/reference/retrieve-a-subscription.md): Use secret API key to retrieve a Subscription. - [List all of Subscriptions](https://docs.paymongo.com/reference/retrieve-list-of-subscriptions.md): Use secret API key to retrieve the list of all Subscriptions created. - [Cancel a Subscription](https://docs.paymongo.com/reference/cancel-a-subscription.md): Use secret API key to cancel a Subscription. - [Update a Subscription Plan](https://docs.paymongo.com/reference/change-a-subscriptions-plan.md): Use secret API key to change the Subscription's Plan. - [Update a Subscription Payment Method](https://docs.paymongo.com/reference/change-a-subscriptions-payment-method.md): Use secret API key to change the Payment Method of the Subscription. - [Create a new test Subscription cycle](https://docs.paymongo.com/reference/trigger-a-new-subscription-cycle.md): Use a test secret API key to manually trigger a new Subscription cycle. - [Invoices](https://docs.paymongo.com/reference/invoice.md) - [Invoice Resource](https://docs.paymongo.com/reference/invoice-resource.md): Invoice serves as a reference of the subscription payment details of a specific cycle, which are automatically generated from an active subscription. - [Create an Invoice Line Item](https://docs.paymongo.com/reference/create-an-invoice-line-item.md): Use secret API key to create an Invoice - [Pay an open Invoice](https://docs.paymongo.com/reference/pay-an-open-invoice.md): Use secret API key for customers to pay an open Invoice - [Retrieve an Invoice](https://docs.paymongo.com/reference/retrieve-an-invoice.md): Use secret API key to retrieve an Invoice - [List all Invoices](https://docs.paymongo.com/reference/retrieve-list-of-all-invoices.md): Use secret API key to retrieve a List of All Invoices - [Plan Resource](https://docs.paymongo.com/reference/plan-resource.md): With Plans, you can create different options for your customers to pay a subscription - [Create a Plan](https://docs.paymongo.com/reference/create-a-plan.md): Use secret API key to create a Plan. - [Retrieve a Plan](https://docs.paymongo.com/reference/retrieve-a-plan.md): Use secret API key to retrieve a Plan. - [Update a Plan](https://docs.paymongo.com/reference/update-a-plan.md): Use secret API key to update a Plan. - [List all Plans](https://docs.paymongo.com/reference/retrieve-list-of-plans.md): Use secret API key to retrieve a List of All Plans. - [Overview](https://docs.paymongo.com/reference/fraud-detection-overview.md) - [Reviews](https://docs.paymongo.com/reference/fraud-reviews.md) - [Review Resource](https://docs.paymongo.com/reference/fraud-review-resource.md): Represents a Review resource for a transaction flagged for manual decision-making. - [Retrieve a Review](https://docs.paymongo.com/reference/fraud-get-a-review.md): Use secret API key to returns a single `Review` resource.. - [List all Reviews](https://docs.paymongo.com/reference/fraud-list-all-reviews.md): Use secret API key to retrieve a list of all `Reviews` resources. - [Approve a Review](https://docs.paymongo.com/reference/fraud-approve-a-review.md): Use secret API key to approves a `Reviews` resource. - [Rules](https://docs.paymongo.com/reference/fraud-rules.md) - [Rule Resource](https://docs.paymongo.com/reference/rule-resource.md): Represent a Rule resource using the specified set of conditions, logical operator, action, and priority order. - [Create a Rule](https://docs.paymongo.com/reference/fraud-create-a-review.md): Use secret API key to create a `Rule` resource. - [Retrieve a Rule](https://docs.paymongo.com/reference/fraud-get-a-rule.md): Use secret API key to returns a single `Rule` resource. - [List all Rules](https://docs.paymongo.com/reference/fraud-list-all-rules.md): Use secret API key to retrieve a list of all fraud `Rule` resources. - [Update a Rule](https://docs.paymongo.com/reference/update-a-rule.md): Use secret API key to update a `Rule` resource. - [Delete a Rule](https://docs.paymongo.com/reference/delete-a-rule.md): Use secret API key to delete a single `Rule` resource. - [Rule attributes](https://docs.paymongo.com/reference/fraud-rule-attributes.md) - [Rule Attribute Resource](https://docs.paymongo.com/reference/fraud-ruleattribute-resource.md): Represent a Rule Attribute resource to construct custom rules. - [List all Rule Attributes](https://docs.paymongo.com/reference/fraud-list-all-rule-attributes.md) - [Scores](https://docs.paymongo.com/reference/fraud-detection-scores.md) - [Score Resource](https://docs.paymongo.com/reference/fraud-detection-score-resource.md): Represent a Score resource for each transaction - [Create a Score](https://docs.paymongo.com/reference/fraud-create-a-score.md): Use secret API key to create a `Score` resource. - [Retrieve a Score](https://docs.paymongo.com/reference/retrieve-a-score.md): Use secret API key to retrieve a `Score` resource. - [List all Scores](https://docs.paymongo.com/reference/fraud-list-all-scores.md): Use secret API key to list `Scores` resources. - [Checkout Session Resource](https://docs.paymongo.com/reference/checkout-session-resource.md) - [Get checkout session](https://docs.paymongo.com/reference/get_checkout_sessions.md): Retrieves a checkout session by ID. First checks DynamoDB, then falls back to core-api for legacy sessions. - [Create checkout session](https://docs.paymongo.com/reference/create_checkout_sessions.md): Creates a new checkout session without creating a Payment Intent. Uses the merchant's secret API key for authentication/authorization but does not persist it in checkout-api-go. If you are building a new integration, we recommend using v2 (`POST /v2/checkout_sessions`) instead — new features are only supported on v2. For example, v2 currently supports pass-on fees. - [Create checkout session](https://docs.paymongo.com/reference/create_checkout_sessions_2.md): Creates a new checkout session without creating a Payment Intent, intended for deferred payment intent flows. Uses the merchant's secret API key for authentication/authorization but does not persist it in checkout-api-go. Recommended for new integrations: future features are only supported on v2. It currently supports pass-on fees. - [Expire checkout session](https://docs.paymongo.com/reference/create_checkout_sessions_id_expire.md): Expires a checkout session, cancelling any associated payment intent if not already cancelled. - [Payment Links](https://docs.paymongo.com/reference/payment-links.md): Create and manage shareable Payment Links through the API, including authentication, response formats, object fields, and migration guidance from legacy Links. - [List Payment Links](https://docs.paymongo.com/reference/get_v1-payment-links.md): Returns payment links. Supports filtering by reference number, status, and mode. - [Create Payment Link](https://docs.paymongo.com/reference/post_v1-payment-links.md): Creates a new payment link. - [Get Payment Link Details](https://docs.paymongo.com/reference/get_v1-payment-links-id.md): Retrieves a payment link by ID. - [Update Payment Link](https://docs.paymongo.com/reference/patch_v1-payment-links-id.md): Updates a payment link. At least one field must be provided. - [List Payments](https://docs.paymongo.com/reference/get_v1-payment-links-id-payments.md): Returns payments associated with a payment link. - [Create Refund](https://docs.paymongo.com/reference/post_v1-payment-links-id-refunds.md): Creates a refund for a payment associated with a payment link. - [List Customers](https://docs.paymongo.com/reference/list_customers.md): Retrieve all customers for the account, with optional filtering by email or phone number - [Get Customer](https://docs.paymongo.com/reference/get_customers.md): Retrieve a single customer by ID - [Create Customer](https://docs.paymongo.com/reference/create_customers.md): Create a new customer with first name, last name, email, and default device - [Update Customer](https://docs.paymongo.com/reference/update_customers.md): Partially update an existing customer — only provided fields are changed - [Update Customer](https://docs.paymongo.com/reference/replace_customers.md): Partially update an existing customer — only provided fields are changed - [Delete Customer](https://docs.paymongo.com/reference/delete_customers.md): Delete a customer by ID - [List Payment Methods for Customer (V1)](https://docs.paymongo.com/reference/list_customers_id_payment_methods.md): Returns all payment methods linked to a customer. Returns 404 if the customer does not exist. - [Delete Payment Method for Customer (V1)](https://docs.paymongo.com/reference/delete_customers_id_payment_methods.md): Deletes a specific payment method linked to a customer. Returns 404 if the customer or payment method does not exist. - [Get Payment Method for Customer](https://docs.paymongo.com/reference/get_customer_payment_methods_customer_id.md): Get a specific customer payment method by customer ID and payment method ID - [List Payment Methods for Customer (V2)](https://docs.paymongo.com/reference/get_customer_payment_methods.md): Get a list of payment methods for a customer with pagination - [Delete Payment Method for Customer](https://docs.paymongo.com/reference/delete_customer_payment_methods_customer_id.md): Delete a customer payment method by customer ID and payment method ID - [List a product's variant matrix](https://docs.paymongo.com/reference/get_products_2.md): Retrieve a product's full set of declared options and variants. - [Replace a product's variant matrix](https://docs.paymongo.com/reference/replace_products.md): Converge a product's declared options and variants against what already exists. - [Delete a variant](https://docs.paymongo.com/reference/delete_products_id.md): Soft-delete a variant by ID, scoped to its product. The default variant and the last remaining active variant cannot be deleted. - [Update a variant](https://docs.paymongo.com/reference/update_products_id.md): Partially update a variant's mutable fields by ID, scoped to its product. - [Get a variant](https://docs.paymongo.com/reference/get_root-1.md): Retrieve a variant by ID for the authenticated account. - [Payouts](https://docs.paymongo.com/reference/payouts.md) - [Payout Resources](https://docs.paymongo.com/reference/payout-resources.md) - [Get Payout List](https://docs.paymongo.com/reference/getpayoutlist.md): Retrieve a list of payouts with filtering and pagination options - [Get Payout Detail by ID](https://docs.paymongo.com/reference/getpayoutdetail.md): Retrieve detailed information about a specific payout by its ID - [Get Payout Transactions by ID](https://docs.paymongo.com/reference/getpayouttransactions.md): Retrieve all transactions (payments, refunds, disputes, etc) associated with a specific payout - [Get Upcoming Payout Amount and Schedule](https://docs.paymongo.com/reference/retrieveschedule.md): Get upcoming payout amount and schedule for a specific merchant by its ID. - [Workflows](https://docs.paymongo.com/reference/v1workflowsid.md) - [Workflow Resources](https://docs.paymongo.com/reference/workflow-resources.md) - [Create a Workflow](https://docs.paymongo.com/reference/createworkflow.md): Creates a new Workflow. - [Retrieve a Workflow](https://docs.paymongo.com/reference/retrieveworkflow.md): Retrieves a specific Workflow by its ID. - [List all Workflows](https://docs.paymongo.com/reference/listworkflows.md): Retrieves a list of all Workflows. - [Delete a Workflow](https://docs.paymongo.com/reference/deleteworkflow.md): Deletes a Workflow by its ID. - [Execute a Workflow by ID](https://docs.paymongo.com/reference/execute-a-workflow-by-id.md): Execute a workflow by workflow ID. - [Triggers](https://docs.paymongo.com/reference/v1rulesid.md) - [Trigger Resources](https://docs.paymongo.com/reference/trigger-resources.md) - [Create a Rule](https://docs.paymongo.com/reference/createrule.md): Creates a new Rule. - [Retrieve a Rule](https://docs.paymongo.com/reference/retrieverule.md): Retrieves a specific Rule by its ID. - [List all Rules](https://docs.paymongo.com/reference/listrules.md): Retrieves a list of all Rules. - [Update a Rule](https://docs.paymongo.com/reference/updaterule.md): Updates an existing Rule by its ID. - [Delete a Rule](https://docs.paymongo.com/reference/deleterule.md): Deletes a rule by its ID. - [Get a Trigger Execution](https://docs.paymongo.com/reference/get-trigger-execution.md): Retrieves a single trigger execution by its ID. - [Submit an Event](https://docs.paymongo.com/reference/submit-an-event.md): Delivers an external event to a workflow instance that is waiting on a wait_event step. - [List policies](https://docs.paymongo.com/reference/list_policies.md): Returns policies visible to the caller, optionally filtered by organization, author, resource, operation, or status. - [Create a policy](https://docs.paymongo.com/reference/create_policy.md): Creates a new policy for an organization from an Open Policy Agent (OPA) Rego source. - [Get a policy](https://docs.paymongo.com/reference/get_policy.md): Returns a single policy by its ID. - [Update a policy](https://docs.paymongo.com/reference/update_policy.md): Updates the mutable fields of an existing policy. Only the fields supplied in the body are changed. - [Evaluate policies](https://docs.paymongo.com/reference/evaluate_policy.md): Evaluates the supplied input against the policies matching the given resource and operation, returning each policy's decision. - [List policy options](https://docs.paymongo.com/reference/get_policy_options.md): Returns the resources and operations that policies are allowed to target. - [Ledgers](https://docs.paymongo.com/reference/ledgers-1.md) - [Create a Ledger](https://docs.paymongo.com/reference/create-ledger.md) - [Retrieve a Ledger](https://docs.paymongo.com/reference/get-ledger.md) - [List all Ledgers](https://docs.paymongo.com/reference/list-ledgers.md) - [Update a Ledger](https://docs.paymongo.com/reference/update-ledger.md) - [Delete a Ledger](https://docs.paymongo.com/reference/delete-ledger.md) - [Ledger Accounts](https://docs.paymongo.com/reference/ledger-accounts.md) - [Create a Ledger Account](https://docs.paymongo.com/reference/create-ledger-account.md) - [Retrieve a Ledger Account](https://docs.paymongo.com/reference/get-ledger-account.md) - [List all Ledger Accounts](https://docs.paymongo.com/reference/list-ledger-accounts.md) - [Update a Ledger Account](https://docs.paymongo.com/reference/update-ledger-account.md) - [Delete a Ledger Account](https://docs.paymongo.com/reference/delete-ledger-account.md) - [Ledger Transactions](https://docs.paymongo.com/reference/ledger-transactions.md) - [Create a Ledger Transaction](https://docs.paymongo.com/reference/create-ledger-transaction.md) - [Retrieve a Ledger Transaction](https://docs.paymongo.com/reference/get-ledger-transaction.md) - [List all Ledger Transactions](https://docs.paymongo.com/reference/list-ledger-transactions.md) - [Update a Ledger Transaction](https://docs.paymongo.com/reference/update-ledger-transaction.md) - [Create a Ledger Transaction Reversal](https://docs.paymongo.com/reference/create-ledger-transaction-reversal.md) - [Ledger Entries](https://docs.paymongo.com/reference/ledger-entries.md) - [Retrieve a Ledger Entry](https://docs.paymongo.com/reference/get-ledger-entry.md) - [List all Ledger Entries](https://docs.paymongo.com/reference/list-ledger-entries.md) - [Update a Ledger Entry](https://docs.paymongo.com/reference/update-ledger-entry.md) - [Ledger Balances](https://docs.paymongo.com/reference/ledger-balances.md) - [Wallet Resource](https://docs.paymongo.com/reference/account-resource.md) - [Wallet Accounts](https://docs.paymongo.com/reference/wallet-accounts.md) - [List all Wallet Accounts](https://docs.paymongo.com/reference/get-account.md): Use secret API key to retrieve Wallet Accounts - [Wallet Resource](https://docs.paymongo.com/reference/wallet-resource.md) - [Retrieve a Wallet](https://docs.paymongo.com/reference/retrieve-a-wallet.md): This document describes the API request for fetching a wallet - [List All Wallet Accounts](https://docs.paymongo.com/reference/list-all-wallet-accounts.md): This document describes the API request to get wallet list for a merchant. - [Transfer Resource](https://docs.paymongo.com/reference/transfer-resource.md): This document describes the fields and resource used in transfers process for PayMongo. - [Create Batch Transfer](https://docs.paymongo.com/reference/create-batch-transfer.md): This document describes the request to create batch transfer. - [Get Batch Transfer](https://docs.paymongo.com/reference/get-batch-transfer.md): This document describes the request to get batch transfer. - [Get Transfer](https://docs.paymongo.com/reference/get-transfer.md): This document describes the request to get transfer. - [Get List Transfer](https://docs.paymongo.com/reference/get-list-transfer.md): This document describes the request to get transfer list. - [Get Receiving Institutions](https://docs.paymongo.com/reference/get-receiving-institutions.md): This document describes the request to get transfer receiving institution based on the provider. - [Rate resource](https://docs.paymongo.com/reference/rate-resource-1.md): The rate of a foreign exchange currency pair - [Search for a Rate by Currency & Provider](https://docs.paymongo.com/reference/search-a-rate-by-currency-and-provider.md): Use an API key to search a forex Rate based on the supplied parameters - [Get forex rate by ID](https://docs.paymongo.com/reference/get_rates-id.md): Retrieves a specific forex rate by its unique identifier - [Quote Resource](https://docs.paymongo.com/reference/quote-resource.md): A quote is a locked-in price of a currency pair that can be used to execute a currency exchange - [Create a Quote](https://docs.paymongo.com/reference/create-a-quote.md): Create a Quote Resource - [Get Quote](https://docs.paymongo.com/reference/get-quote.md): Get a Quote - [Card Programs](https://docs.paymongo.com/reference/card-programs.md) - [Create a Card Program](https://docs.paymongo.com/reference/create-a-card-program.md) - [Retrieve a Card Program](https://docs.paymongo.com/reference/retrieve-a-card-program.md) - [List all Card Programs](https://docs.paymongo.com/reference/list-all-card-programs.md) - [Cardholders](https://docs.paymongo.com/reference/cardholders.md) - [Create a Cardholder](https://docs.paymongo.com/reference/create-a-cardholder.md) - [Retrieve a Cardholder](https://docs.paymongo.com/reference/retrieve-a-cardholder.md) - [List all Cardholders](https://docs.paymongo.com/reference/list-all-cardholders.md) - [Cards](https://docs.paymongo.com/reference/cards.md) - [Create a Card](https://docs.paymongo.com/reference/create-a-card.md) - [Retrieve a Card](https://docs.paymongo.com/reference/retrieve-a-card.md) - [List all Cards](https://docs.paymongo.com/reference/list-all-cards.md) - [Update a Card](https://docs.paymongo.com/reference/update-a-card.md) - [Accounts](https://docs.paymongo.com/reference/accounts.md) - [Account Resource](https://docs.paymongo.com/reference/platforms-account-resource.md) - [Create Account](https://docs.paymongo.com/reference/platforms-create-account.md): Create a new child account (merchant or consumer) with minimal data. - [Create Identity Verification Session (with hosted website)](https://docs.paymongo.com/reference/platforms-account-identity-verification.md): Create a session to perform Identity Verification which will return a URL to a hosted web verification page. The user will perform a selfie and government ID capture for biometrics and ID face match. Only the account itself or its parent account can create a verification session. - [Create Identity Verification (API only flow)](https://docs.paymongo.com/reference/createverificationapi.md): Submit document images and a selfie photo directly to perform identity verification only with API (without the need to open hosted verification website). The caller uploads files via multipart/form-data. Only the account itself or its parent account can create a verification session. **Primary vs Secondary IDs:** Document types are classified as either primary or secondary. Primary IDs require only 1 document. Secondary IDs require 2 different secondary documents. - [Update Account](https://docs.paymongo.com/reference/platforms-update-account.md): Update account person information. After identity verification, some fields are pre-filled from the captured ID. Other required information should be added to prepare for account activation. Only the account itself or its parent account can perform the update. - [Activate Account](https://docs.paymongo.com/reference/platforms-activate-account.md): Activate the account once all requirements are fulfilled. If there are missing requirements, it will return an error with details about the missing fields. Only the account itself or its parent account can activate the account. - [Get Account](https://docs.paymongo.com/reference/platforms-get-account.md): Retrieve account details by account ID. Only the account itself or its parent account can access the data. - [Accounts Webhook](https://docs.paymongo.com/reference/accounts-webhook.md) - [Relationships](https://docs.paymongo.com/reference/linked-accounts-relationships.md) - [Relationship Resource](https://docs.paymongo.com/reference/linked-accounts-relationship-resource.md) - [List Relationships](https://docs.paymongo.com/reference/linked-accounts-list-relationships.md): List relationships where the authenticated account is the parent or the child. Each relationship includes basic details of the parent and child accounts, not just their IDs. Results are ordered newest first and paginated with an opaque cursor. When `has_more` is true, pass the returned `cursor` to the next call to fetch the next page. Treat the cursor as an opaque value and URL-encode it when sending. - [Get Relationship](https://docs.paymongo.com/reference/linked-accounts-get-relationship.md): Retrieve a relationship by ID. The response includes basic details of the parent and child accounts, not just their IDs. Only the parent account or the child account of the relationship can access it. - [Webhooks Resource](https://docs.paymongo.com/reference/webhook-resource.md) - [Create a Webhook](https://docs.paymongo.com/reference/create-a-webhook.md): This endpoint creates a webhook that listens to the specified event types and sends POST requests to the provided URL. - [Update a Webhook](https://docs.paymongo.com/reference/update-a-webhook.md): Updates an existing webhook’s URL or event types using its ID. - [Retry a Webhook Delivery Attempt](https://docs.paymongo.com/reference/retry-a-webhook-delivey-attempt.md): Retry a previously failed or unprocessed webhook delivery attempt using the same event data as the original. Only available for enabled webhooks. - [Batch Transfer](https://docs.paymongo.com/reference/batch-transfer.md) - [Batch Transaction Resource](https://docs.paymongo.com/reference/batch-transaction-resource.md) - [Create a Batch Transaction](https://docs.paymongo.com/reference/create-a-batch-transaction.md): Use secret API key to create a Batch Transaction - [Retrieve a Batch Transcation](https://docs.paymongo.com/reference/retrieve-batch-object.md): Use secret API key to retrieve Batch Object - [List all Batch Transactions](https://docs.paymongo.com/reference/retrieve-list-of-batches.md): Use secret API key to retrieve List of Batches - [Wallet Transaction V1 Resource](https://docs.paymongo.com/reference/wallet-transaction-resource.md) - [List all Receiving Institutions](https://docs.paymongo.com/reference/list-all-receiving-institutions.md): Use secret API key to retrieve a List of All Receiving Institutions - [Create a Wallet Transaction](https://docs.paymongo.com/reference/create-a-wallet-transaction.md): Use secret API key to create a Wallet Transaction - [Retrieve a Wallet Transaction](https://docs.paymongo.com/reference/retrieve-a-wallet-transaction.md): Use secret API key to retrieve Wallet Transactions by ID - [Create Legacy Link](https://docs.paymongo.com/reference/post_v1-links.md): Creates a legacy link. - [Get Legacy Link](https://docs.paymongo.com/reference/get_v1-links-id.md): Retrieves a legacy link using either the legacy link ID or its reference number. - [Archive Legacy Link](https://docs.paymongo.com/reference/post_v1-links-id-archive.md): Archives a legacy link. - [Unarchive Legacy Link](https://docs.paymongo.com/reference/post_v1-links-id-unarchive.md): Unarchives a legacy link. - [List invoices](https://docs.paymongo.com/reference/list_invoices-1.md): Lists the caller org's invoices. Without `page` it cursor-paginates (`starting_after` + `has_more`). With `page` it serves an offset page with `total`/`page_count` meta, plus sorting (`order_by`/`order`) and a `query` search; the `sent` and `overdue` statuses are read-time projections of `open` split by due date. - [Create a draft invoice](https://docs.paymongo.com/reference/create_invoices-1.md): Creates a new sales invoice in `draft` for the caller's organization. Line items and payment methods are optional at create (a partial draft is valid); the at-least-one-line-item rule is enforced at send time. - [Retrieve an invoice](https://docs.paymongo.com/reference/get_invoices-1.md): Returns one invoice owned by the caller's organization. - [Update a draft invoice](https://docs.paymongo.com/reference/update_invoices-1.md): Partially updates an invoice while it is still in `draft`. Only the provided fields change; sent invoices can no longer be edited. - [Render an invoice PDF](https://docs.paymongo.com/reference/create_invoices_id_pdf-1.md): Renders the invoice as a PDF and streams the bytes inline (`Content-Disposition: inline`). POST because it re-renders on every call; nothing is persisted. - [Send a payment reminder](https://docs.paymongo.com/reference/create_invoices_id_remind-1.md): Re-sends the invoice email as a reminder while the invoice is `open`. The optional body can override the recipient and add a personal message. - [Retrieve an invoice's reminder schedule](https://docs.paymongo.com/reference/list_invoices_id_reminders.md): Returns the automatic-reminder timeline for one invoice owned by the caller's organization: each milestone's scheduled date and sent state, the sent/total counts, and the next upcoming reminder. - [Send an invoice](https://docs.paymongo.com/reference/create_invoices_id_send-1.md): Finalizes a draft to `open`: mints a hosted checkout session and emails the customer. The optional body's `notify: false` finalizes without the checkout session or email, for callers that collect payment themselves. A notify send needs at least one `payment_methods` entry on the invoice and is rejected with 422 without one. It fails with 502 (invoice stays `draft`) if the checkout session cannot be minted. - [Export invoices as CSV](https://docs.paymongo.com/reference/list_invoices_export-1.md): Streams a CSV of the caller org's invoices matching the filters. The response carries every match, up to 10000 rows; narrow the filters when the match set is larger. This endpoint is not paginated: limit and starting_after are rejected. - [Get the org's invoice summary](https://docs.paymongo.com/reference/list_invoices_summary-1.md): Returns the organization-wide outstanding / overdue / paid-this-month amounts and counts (centavos), independent of list filters and pagination. - [Approval decision callback (approvals-api)](https://docs.paymongo.com/reference/create_invoices_approvals_callback.md): Receives the signed final maker-checker decision for a parked invoice send. Authenticated by the Paymongo-Signature HMAC (keyed on the approval id), not by merchant credentials. approved unblocks the send; declined returns the invoice to an editable draft. - [List repeating invoices](https://docs.paymongo.com/reference/list_invoices_recurring.md): Lists the caller org's recurring registrations, cursor-paginated (starting_after + has_more), most recently created first. - [Register a repeating invoice](https://docs.paymongo.com/reference/create_invoices_recurring.md): Creates a send-mode recurring registration for the caller's organization: the customer is emailed a payable checkout link on every cycle. start_date must be tomorrow or later in Asia/Manila; cycles send at a fixed 09:00 Manila, and for monthly and yearly cadences, day 29-31 anchors clamp to the 28th (weekly and daily keep the picked date). - [Retrieve a repeating invoice](https://docs.paymongo.com/reference/get_invoices_recurring.md): Returns one recurring registration owned by the caller's organization. A foreign or cross-mode id reads as 404. - [Update a repeating invoice's customer email](https://docs.paymongo.com/reference/update_invoices_recurring.md): Changes the email future cycles bill to. The only patchable field - cadence, amount, and schedule are frozen at registration. A foreign or cross-mode id reads as 404. - [Cancel a repeating invoice](https://docs.paymongo.com/reference/create_invoices_recurring_id_cancel.md): Stops the schedule for good. Idempotent on an already-cancelled registration. A foreign or cross-mode id reads as 404. - [Pause a repeating invoice](https://docs.paymongo.com/reference/create_invoices_recurring_id_pause.md): Stops firing while keeping the registration resumable. Idempotent on an already-paused registration. A foreign or cross-mode id reads as 404. - [Resume a repeating invoice](https://docs.paymongo.com/reference/create_invoices_recurring_id_resume.md): Re-attaches a schedule trigger and returns a paused registration to active. Only a paused registration can resume - every other status, including already-active, is rejected. A foreign or cross-mode id reads as 404. - [Schedule a draft invoice to send on a future date](https://docs.paymongo.com/reference/create_invoices_id_schedule.md): Stores a send date on a draft. The invoice stays `draft` and nothing is emailed until the date passes, at which point the ordinary send runs: the checkout link is minted, the customer is emailed, and any maker-checker approval applies exactly as it would for a manual send. Rejects a non-draft (422) and a date that is not in the future (400). - [Cancel a scheduled send](https://docs.paymongo.com/reference/create_invoices_id_schedule_cancel.md): Removes the send date from a draft, leaving it as an ordinary unsent draft. Answers 404 when the invoice has no schedule. - [Void an invoice](https://docs.paymongo.com/reference/create_invoices_2.md): Transitions an `open` invoice to `void`. Voided invoices can no longer be paid. - [Retrieve an invoice by hosted slug (public)](https://docs.paymongo.com/reference/get_invoices_by_slug-1.md): Returns the customer-facing view of an invoice by its hosted-page slug, including the merchant's display name and with merchant-only fields (internal notes) redacted. Unauthenticated: the unguessable slug is the capability. - [Attach a checkout session by hosted slug (public)](https://docs.paymongo.com/reference/update_invoices_by_slug-1.md): Sets the checkout session ID on the invoice with the given hosted slug (used by the hosted page when the customer starts payment). Returns the same customer-facing payload as the by-slug retrieve. - [Retrieve the settling payment by hosted slug (public)](https://docs.paymongo.com/reference/list_invoices_by_slug_slug_payment-1.md): Returns the payment that settled the invoice, for the hosted page's paid landing. 404 until the invoice is paid (or when the slug is unknown). - [Download the invoice PDF by hosted slug (public)](https://docs.paymongo.com/reference/list_invoices_by_slug_slug_pdf-1.md): Renders the invoice as a PDF and streams it inline, for the hosted page's Download PDF button. Unauthenticated: the unguessable slug is the capability. - [Upload a CSV to start a bulk import](https://docs.paymongo.com/reference/create_invoices_imports-1.md): Starts a bulk invoice import. The request is `multipart/form-data` with a single required `file` part carrying the CSV (max 5 MiB, up to 1000 rows), e.g. `curl -F "file=@july-invoices.csv"`. The response carries the new batch plus the detected column headers for the mapping step and a duplicate-upload warning. (The file part is described here rather than as a schema: the swag pipeline cannot attach the §10-required example to a binary multipart property.) - [Get an import batch](https://docs.paymongo.com/reference/get_invoices_imports-1.md): Returns the batch's status, progress counters, and ready/error/created/failed tally. Polled by the create step. - [Confirm creation of a validated import](https://docs.paymongo.com/reference/create_invoices_imports_id_create-1.md): Enqueues the async create job for a `ready` batch and returns 202 with the batch now `creating`. `send_mode` defaults to `draft`; `create_and_send` also sends each created invoice and requires at least one `payment_methods` entry, applied to every invoice in the batch (422 without one). 409 when the batch is not ready. - [Apply a column mapping](https://docs.paymongo.com/reference/update_invoices_imports_id_mapping-1.md): Maps each detected CSV column header onto a canonical invoice field, re-validates every row, and returns the batch with its new ready/error tally. - [Download the import result report](https://docs.paymongo.com/reference/list_invoices_imports_id_report-1.md): Streams the result report as CSV: one record per source row with its create outcome and, when created, the invoice ID. Generated on demand; no file is persisted. - [List the import's rows for review](https://docs.paymongo.com/reference/list_invoices_imports_id_rows-1.md): Returns every parsed row (or the subset matching `status`) plus the batch tally. Imports are capped at 1000 rows so the whole set fits one response; there is no pagination. - [Fix one import row inline](https://docs.paymongo.com/reference/update_invoices_imports_id_rows-1.md): Merges the sent canonical fields onto the row's mapped data, re-validates it, and returns the updated row plus the new batch tally. 409 once the import has left review (the worker is already creating invoices). - [Download the import CSV template](https://docs.paymongo.com/reference/list_invoices_imports_template-1.md): Streams the canonical CSV template (header row only) whose columns map 1:1 onto the importable invoice fields. - [Search previously-billed contacts](https://docs.paymongo.com/reference/list_invoices_contacts-1.md): Returns the caller org's previously-billed customers whose name or email prefix-matches the query, most-recently-used first, for the create-flow BILL TO autocomplete. Queries under the minimum length return an empty list. - [Get invoice branding](https://docs.paymongo.com/reference/list_invoices_branding-1.md): Returns the org-level invoice branding (logo, accent color) applied to hosted pages, PDFs, and emails. - [Set invoice branding](https://docs.paymongo.com/reference/replace_invoices_branding-1.md): Upserts the org-level invoice branding (logo, accent color). - [Get invoice settings](https://docs.paymongo.com/reference/list_invoices_settings.md): Returns the organization's invoice settings for the calling key's mode. approvals_enabled is the maker-checker switch: with it off, a send is never evaluated against approvals-api at all. - [Update invoice settings](https://docs.paymongo.com/reference/update_invoices_settings.md): Updates the organization's invoice settings for the calling key's mode. Turning approvals off leaves invoices already parked behind an open approval as they are: they clear on a decision, or when the merchant edits them. - [Get invoices product-spotlight state](https://docs.paymongo.com/reference/list_invoices_spotlight.md): Returns the spotlight seen flag and whether the org has any invoices (eligibility for the one-time spotlight). - [Mark invoices product-spotlight as seen](https://docs.paymongo.com/reference/replace_invoices_spotlight.md): Records that the merchant has seen the spotlight (idempotent upsert). - [List expenses](https://docs.paymongo.com/reference/list_expenses.md): Lists expenses visible to the authenticated organization with cursor pagination and optional summary totals. - [Create an expense](https://docs.paymongo.com/reference/create_expense.md): Creates an itemized organization expense and starts its approval flow when applicable. - [Delete an expense](https://docs.paymongo.com/reference/delete_expense.md): Marks an expense as deleted and returns its latest representation. - [Get an expense](https://docs.paymongo.com/reference/get_expense.md): Returns one expense visible to the authenticated organization. - [Update an expense](https://docs.paymongo.com/reference/update_expense.md): Updates mutable expense details or approval status. - [Analyze an expense receipt](https://docs.paymongo.com/reference/analyze_expense_receipt.md): Extracts merchant, amount, currency, date, category, and line-item details from a receipt. - [Upload an expense receipt file](https://docs.paymongo.com/reference/upload_expense_receipt_file.md): Uploads a receipt image or document for later attachment to an expense. - [Retrieve an expense receipt file](https://docs.paymongo.com/reference/get_expense_receipt_file.md): Returns file metadata and a fresh signed download URL for an account-scoped receipt. - [List brand profiles](https://docs.paymongo.com/reference/list_branding_profiles.md): Returns all brand profiles for the org; creates a default profile if none exist. - [Create brand profile](https://docs.paymongo.com/reference/create_branding_profiles.md) - [Delete brand profile](https://docs.paymongo.com/reference/delete_branding_profiles.md) - [Get brand profile](https://docs.paymongo.com/reference/get_branding_profiles.md) - [Update brand profile](https://docs.paymongo.com/reference/replace_branding_profiles.md) - [List channel assignments](https://docs.paymongo.com/reference/list_branding_assignments.md) - [Upsert channel assignments](https://docs.paymongo.com/reference/replace_branding_assignments.md): Set profile_id to null to clear an assignment for a channel or resource. - [Init marketing visitor](https://docs.paymongo.com/reference/init_visitor.md): S2S from the marketing site or signup page. Requires the same Bearer JWT as other /v1/internal routes (HS256). admin_id is not required. recorded_from is the page: landing (website) or signup. When visitor_id already exists it is reused and no new visitor is created. When visitor_id is missing, invalid, or not yet stored a visitor is created. Optional UTM fields are stored as a touchpoint; if none are provided the touchpoint is recorded as source=direct. A new touchpoint row is inserted only when the channel or page differs from the visitor's latest touchpoint. - [List form layouts](https://docs.paymongo.com/reference/list_internal_form_layouts.md) - [Create form layout](https://docs.paymongo.com/reference/create_internal_form_layouts.md) - [Delete form layout](https://docs.paymongo.com/reference/delete_internal_form_layouts.md) - [Get form layout](https://docs.paymongo.com/reference/get_internal_form_layouts.md) - [Patch form layout](https://docs.paymongo.com/reference/update_internal_form_layouts.md) - [Replace form layout structure](https://docs.paymongo.com/reference/replace_internal_form_layouts_form_layout_id_structure.md) - [Get active form layout by record type](https://docs.paymongo.com/reference/list_internal_form_layouts_active.md) - [List loss reasons](https://docs.paymongo.com/reference/list_internal_loss_reasons.md) - [List owners](https://docs.paymongo.com/reference/list_internal_owners.md) - [List product items](https://docs.paymongo.com/reference/list_internal_product_items.md): List product items with optional filters. Cursor pagination: reuse the same query params when following `cursor`. - [List onboarding requests](https://docs.paymongo.com/reference/list_requests.md): Lists onboarding requests with optional filtering by status, product code, assignee, dates, etc. Supports cursor-based pagination. - [Create onboarding request](https://docs.paymongo.com/reference/create_requests.md): Creates a new onboarding request with KYB data for the specified product. Returns the created request with initial draft status. - [Get onboarding request by ID](https://docs.paymongo.com/reference/get_requests.md): Retrieves a single onboarding request with all details. Audit history is ops-only and is not returned here — see the internal endpoint. - [Update request information](https://docs.paymongo.com/reference/update_requests.md): Updates basic request information including assignee email, internal notes, and kyb_data. kyb_data is optional and shallow-merged into what's already stored (submitted keys overwrite/add, the rest is left untouched) and re-validated the same way CreateRequest validates it. Does not change request status. - [Cancel onboarding request](https://docs.paymongo.com/reference/create_requests_id_cancel.md): Cancels an onboarding request. Allowed from draft, submitted, under_review, or pending_clarification. Rejected once the request is processing (the product is already being provisioned) or in a terminal status (completed, declined, cancelled). - [Resubmit request after clarification](https://docs.paymongo.com/reference/create_requests_id_resubmit.md): Transitions request status from pending_clarification back to under_review after merchant has addressed the requested clarification. Requires the request to already have an assignee. - [Submit request for review](https://docs.paymongo.com/reference/create_requests_id_submit.md): Transitions request status from draft to submitted, indicating the merchant has completed initial submission. - [Get payment-method requirements / eligibility](https://docs.paymongo.com/reference/get_requests_eligibility.md): Evaluates the authenticated account against a payment method's requirements. Returns eligible=true when the account qualifies, otherwise eligible=false with the list of missing business type / documents / fields — the same set enforced when creating a request. - [List workflows](https://docs.paymongo.com/reference/list_workflows.md) - [Workflow Parser](https://docs.paymongo.com/reference/create_workflows.md): Parse a workflow template and return the structured workflow definition - [Delete workflow (soft delete)](https://docs.paymongo.com/reference/delete_workflows.md) - [Get workflow by ID](https://docs.paymongo.com/reference/get_workflows.md) - [Update a workflow](https://docs.paymongo.com/reference/replace_workflows.md): Replaces the mutable fields of an existing workflow. Superuser only. Requires the current version in the If-Match header (optimistic lock). Body is the workflow YAML definition. - [Execute a workflow asynchronously](https://docs.paymongo.com/reference/create_workflows_id_run.md): Queues a workflow execution request for asynchronous processing. Returns immediately with status 'queued'. Use GET /v1/instances to check execution status. - [Validate Workflow Definition](https://docs.paymongo.com/reference/create_workflows_2.md): Validates a workflow YAML definition against the CUE schema without creating database records - [List workflow templates](https://docs.paymongo.com/reference/list_workflow_templates-1.md): Returns a paginated list of reusable workflow definition templates. - [Create a workflow template](https://docs.paymongo.com/reference/create_workflow_template.md): Creates a reusable workflow definition template. Superuser only. - [Delete a workflow template](https://docs.paymongo.com/reference/delete_workflow_template.md): Deletes a reusable workflow definition template. Superuser only. - [Get a workflow template by ID](https://docs.paymongo.com/reference/get_workflow_template.md): Returns a single reusable workflow definition template. - [List triggers by organization ID](https://docs.paymongo.com/reference/list_workflows_triggers.md) - [Create a new trigger](https://docs.paymongo.com/reference/create_workflows_triggers.md) - [Delete a trigger](https://docs.paymongo.com/reference/delete_workflows_triggers.md) - [Get a trigger by ID](https://docs.paymongo.com/reference/get_workflows_triggers.md) - [Update trigger by ID](https://docs.paymongo.com/reference/replace_workflows_triggers.md) - [Check whether a trigger exists for an (org, event_name, livemode) tuple](https://docs.paymongo.com/reference/list_workflows_triggers_exists.md): Pre-publish guard used by transfers-go-api. Returns {"exists":true/false}. Restricted to internal service callers — the superuser secret key must be supplied via Basic auth. - [List trigger executions](https://docs.paymongo.com/reference/list_trigger_executions.md): Returns a paginated history of trigger firings. Supports filtering by trigger_id and state. - [Get a trigger execution by ID](https://docs.paymongo.com/reference/get_trigger_execution.md): Returns a single trigger firing record. - [List workflow instances with current step info](https://docs.paymongo.com/reference/list_workflows_instances.md): Returns paginated list of workflow execution instances with their current step status. Supports filtering by workflow_id, status, and current_step_status. - [Get workflow instance details](https://docs.paymongo.com/reference/get_workflows_instances.md): Returns detailed information about a workflow execution instance, including all current step states. - [Submit an external event to a waiting instance](https://docs.paymongo.com/reference/create_workflows_instances_id_events.md): Delivers an external event to a workflow instance that is paused on a wait_event step, resuming its execution. - [Get workflow instance execution history](https://docs.paymongo.com/reference/list_workflows_instances_id_history.md): Returns complete execution history for a workflow instance, including all retry attempts for each step. - [Get retry history for a specific step](https://docs.paymongo.com/reference/list_workflows_instances_id_steps_index_history.md): Returns all retry attempts for a specific step in a workflow instance. This endpoint queries stored step history directly for fast retrieval. - [Get current steps for an instance](https://docs.paymongo.com/reference/list_workflows_instances_id_steps_current.md): Returns all current step states for a workflow instance (without history). This endpoint queries the database directly for optimal performance. - [Get wait states for an instance](https://docs.paymongo.com/reference/get_wait_states.md): Returns the wait_event steps currently pending on a workflow instance. - [List all waiting instances for an organization](https://docs.paymongo.com/reference/list_workflows_instances_waiting.md): Returns paginated list of workflow instances currently waiting for external events. Supports filtering by workflow_id and event_name. - [Get aggregate workflow statistics](https://docs.paymongo.com/reference/list_workflows_stats.md): Returns aggregate counts for active workflows, configured triggers, and execution totals. Superuser only; may be scoped to a specific organization via the organization_id query param. - [List applications](https://docs.paymongo.com/reference/list_capitals_applications.md): Get a list of all applications - [Submit a Loan Application](https://docs.paymongo.com/reference/create_capitals_applications.md): Submits a new loan application with the provided details - [List applications for lender](https://docs.paymongo.com/reference/list_capitals_lenders_applications.md): Get a list of all applications for logged in lender - [Get application detail for lender](https://docs.paymongo.com/reference/get_capitals_lenders_applications.md): Retrieves detailed information about a specific application for lender access, including links to all required documents such as government ID, signed SOA, etc. - [Decide an Application by Lender](https://docs.paymongo.com/reference/create_capitals_lenders_applications_application_id_decide.md): Handles the approval of an application by a lender - [List all offers](https://docs.paymongo.com/reference/list_capitals_lenders_offers.md): Retrieve a list of all offers created by the lender - [Create a new offer](https://docs.paymongo.com/reference/create_capitals_lenders_offers.md): Create a new offer for accounts - [Delete offer](https://docs.paymongo.com/reference/delete_capitals_lenders_offers.md): Delete an existing offer by ID - [Get offer by ID](https://docs.paymongo.com/reference/get_capitals_lenders_offers.md): Retrieve a single offer by its ID - [Update an offer](https://docs.paymongo.com/reference/replace_capitals_lenders_offers.md): Update an offer for accounts - [Get offer accounts](https://docs.paymongo.com/reference/list_capitals_lenders_offers_offer_id_accounts.md): Retrieve the list of accounts associated with an offer - [Send offer to targeted accounts](https://docs.paymongo.com/reference/create_capitals_lenders_offers_offer_id_accounts.md): Allow lender to send offer to particular accounts so they can borrow money from offer - [Delete offer account](https://docs.paymongo.com/reference/delete_capitals_lenders_offers_offer_id_accounts.md): Remove an invited account from an offer - [List offers for an account](https://docs.paymongo.com/reference/list_capitals_offers.md): Retrieves a list of offers associated with a specific account - [List contracts](https://docs.paymongo.com/reference/list_capitals_contracts.md): Retrieves all contracts for the authenticated account, including associated loans and available credit limit. - [Create withdrawal](https://docs.paymongo.com/reference/create_capitals_contracts_contract_id_withdrawals.md): Draws down funds from an active revolving credit line contract. - [List lender contracts](https://docs.paymongo.com/reference/list_capitals_lenders_contracts.md): Retrieves all contracts for the authenticated lender, including associated loans. - [Simulate a repayment](https://docs.paymongo.com/reference/create_capitals_lenders_contracts_contract_id_simulate_repayment.md): Simulates the automatic daily sales repayment for a contract. Updates loan balance and creates a repayment record, but does not trigger a wallet transfer. - [List repayments for lender](https://docs.paymongo.com/reference/list_capitals_lenders_repayments.md): Retrieves all repayments for the authenticated lender. - [Create a direct lender repayment](https://docs.paymongo.com/reference/create_capitals_lenders_repayments.md): Notifies the system that a direct repayment was made to the lender. - [List repayments](https://docs.paymongo.com/reference/list_capitals_repayments.md): Retrieves all repayments for the authenticated account. - [Create a manual repayment](https://docs.paymongo.com/reference/create_capitals_repayments.md): Creates a manual repayment entry for a loan or account. - [Get lender configuration](https://docs.paymongo.com/reference/list_capitals_lenders_lender_id_configs.md): Returns the current configuration for the lender - [Upsert lender configuration](https://docs.paymongo.com/reference/replace_capitals_lenders_configs.md): Creates or updates the configuration for the authenticated lender - [Get anonymized transaction manifest](https://docs.paymongo.com/reference/list_capitals_lenders_anonymized-transactions_manifest.md): Returns a list of available anonymized transaction files with presigned S3 download URLs - [List orders](https://docs.paymongo.com/reference/list_orders.md): Lists the organization's orders, optionally filtered by location, touchpoint, status, and date range. - [Create an order](https://docs.paymongo.com/reference/create_order.md): Creates a dine-in order for a touchpoint. livemode and organization are derived from the merchant secret key. - [Retrieve an order](https://docs.paymongo.com/reference/get_order.md): Retrieves a single order by ID, scoped to the caller's organization. - [Update an order](https://docs.paymongo.com/reference/update_order.md): Updates an order's items, tips, custom fees, customer, or metadata. On a group order every update requires a participant_id belonging to a group that has not expired; version drives optimistic locking. - [Bill an order](https://docs.paymongo.com/reference/bill_order.md): Bills an order, creating checkout session(s). The body is optional for single-customer orders; split_mode and breakdown drive group orders. - [Cancel an order](https://docs.paymongo.com/reference/cancel_order.md): Cancels an order. livemode and organization are derived from the merchant secret key. - [Update fulfillment status](https://docs.paymongo.com/reference/update_order_fulfillment.md): Sets the merchant-controlled fulfillment status of an order, independent of its payment status. - [Promote an order to a group order](https://docs.paymongo.com/reference/promote_order_group.md): Converts a single-customer order into a group order with the given participants, enabling split payments. - [Dissolve a group order](https://docs.paymongo.com/reference/dissolve_order_group.md): Reverts a group order back to a single-customer order, cancelling any pending per-participant sessions. - [Export orders as CSV](https://docs.paymongo.com/reference/export_orders.md): Streams a CSV report of orders in a date range (≤ 1 month, starting ≤ 1 year ago). Set payments=true for a payment-grained report (one row per checkout session). - [Retrieve the merged catalog](https://docs.paymongo.com/reference/get_catalog.md): Returns the merged menu (categories and items with live products-api name/price) for a scope. - [List categories](https://docs.paymongo.com/reference/list_categories.md): Lists menu categories for a scope (optional location_slug; omit for the org root). - [Create a category](https://docs.paymongo.com/reference/create_category.md): Creates a menu category. location_slug is optional (omit for org-level). - [Delete a category](https://docs.paymongo.com/reference/delete_category.md): Soft-deletes a category by its ID. - [Update a category](https://docs.paymongo.com/reference/update_category.md): Updates a category's name, sort order, or enabled flag. - [Create an item](https://docs.paymongo.com/reference/create_item.md): Creates a menu item linked to a products-api product. location_slug is optional (omit for org-level). - [Delete an item](https://docs.paymongo.com/reference/delete_item.md): Soft-deletes a menu item by its ID. - [Update an item](https://docs.paymongo.com/reference/update_item.md): Updates a menu item's category, sort order, or availability. - [List locations](https://docs.paymongo.com/reference/list_locations.md): Lists the organization's catalog locations. - [Create a location](https://docs.paymongo.com/reference/create_location.md): Creates a catalog location for the caller's organization. - [Delete a location](https://docs.paymongo.com/reference/delete_location.md): Soft-deletes a location by its slug. - [Retrieve a location](https://docs.paymongo.com/reference/get_location.md): Retrieves a single location by its slug. - [Update a location](https://docs.paymongo.com/reference/update_location.md): Updates a location's name, review URL, or status. The slug is immutable. - [List touchpoints](https://docs.paymongo.com/reference/list_touchpoints.md): Lists touchpoints for a scope (optional location_slug; omit for the org root). - [Create touchpoints](https://docs.paymongo.com/reference/create_touchpoints.md): Creates one or more touchpoints. Accepts a single touchpoint or a bulk list; location_slug is optional (omit for org-level). - [Delete a touchpoint](https://docs.paymongo.com/reference/delete_touchpoint.md): Soft-deletes a touchpoint by its code within a scope. - [Retrieve a touchpoint](https://docs.paymongo.com/reference/get_touchpoint.md): Retrieves a single touchpoint by its code within a scope. - [Update a touchpoint](https://docs.paymongo.com/reference/update_touchpoint.md): Updates a touchpoint's display name within a scope. - [List inventory items](https://docs.paymongo.com/reference/list_inventory_items.md): List inventory items for the authenticated organization and live mode, optionally filtered by warehouse_id/variant_id, cursor-paginated. - [Create an inventory item](https://docs.paymongo.com/reference/create_inventory_items.md): Create a stock record for a variant at a warehouse. on_hand defaults to zero; a non-zero initial on_hand writes a correction movement. - [Get an inventory item](https://docs.paymongo.com/reference/get_inventory_items.md): Retrieve a single inventory item by id. Merchants authenticate with a secret key; internal services must pass ?livemode explicitly. - [Set or clear an item's low stock threshold](https://docs.paymongo.com/reference/update_inventory_items.md): Set the low stock threshold, or clear it by omitting the field or passing null. - [Apply a relative stock adjustment](https://docs.paymongo.com/reference/create_inventory_items_id_adjustments.md): Add or subtract a delta from an item's on_hand count and record a movement. Refused when the result would go negative or below held. - [Apply an absolute stock count](https://docs.paymongo.com/reference/create_inventory_items_id_counts.md): Set an item's on_hand count to an absolute value, recorded as one correction movement. A count equal to the current on_hand succeeds without writing a movement. Refused when the count would fall below held. - [List an item's movement ledger](https://docs.paymongo.com/reference/list_inventory_items_id_movements.md): Cursor-paginated history of movements for an item, newest first. - [List warehouses](https://docs.paymongo.com/reference/list_warehouses.md): List every warehouse for the authenticated organization and live mode. - [Create a warehouse](https://docs.paymongo.com/reference/create_warehouses.md): Create a stock-keeping warehouse scoped to the authenticated organization and live mode. - [Get a warehouse](https://docs.paymongo.com/reference/get_warehouses.md): Retrieve a single warehouse by id. - [Update a warehouse](https://docs.paymongo.com/reference/update_warehouses.md): Update a warehouse's name and/or disabled flag. Omitted fields are left untouched. - [Open a hold](https://docs.paymongo.com/reference/create_holds.md): Reserve quantities against one or more inventory items. Validation is all-or-nothing: if any line lacks availability, the whole hold is refused and nothing is held. - [Get a hold](https://docs.paymongo.com/reference/get_holds.md): Retrieve a single hold with its lines. - [Get stock availability](https://docs.paymongo.com/reference/create_availability.md): Look up available stock per requested variant across its non-disabled warehouses, optionally filtered to a set of warehouses. Read-only; a variant with no items still appears with a zero total.