PayPlug Payments API
★ Only Publicly Available OpenAPI DocumentPaymentsPayment Processingbearer11 EndpointsREST
For Agents
Accept card payments, process refunds, manage stored cards, and create installment payment plans for French and European merchants.
Use for: I need to process a card payment through PayPlug, I want to create an installment plan for a large purchase, Issue a refund for a PayPlug payment, Retrieve stored card details for a returning customer
Not supported: Does not handle bank transfers, direct debits, or multi-country payment routing — use for card payments, refunds, and installment plans in the French market only.
Jentic publishes the only available OpenAPI specification for PayPlug Payments API, keeping it validated and agent-ready. PayPlug is a French payment processor that enables merchants to accept card payments, process refunds, manage stored cards, and offer installment payment plans. The API provides 11 endpoints covering the full payment lifecycle from creation through refund and supports French market features like 3x/4x installment plans (paiement en plusieurs fois).
Install Jentic One Beta
Connect the PayPlug Payments API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PayPlug Payments API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with PayPlug Payments API.
Accept card payments with 3D Secure authentication and hosted payment pages
Process full and partial refunds against completed payments
Store and manage customer card details for repeat purchases
Create installment payment plans (3x or 4x) for higher-value transactions
Retrieve payment and refund details with full transaction metadata
Track installment plan status and individual installment completion
Use Cases
Patterns agents use PayPlug Payments API for, with concrete tasks.
★ French E-Commerce Payment Acceptance
Accept card payments from French and European customers through PayPlug's payment gateway. The API supports hosted payment pages with 3D Secure authentication, reducing PCI compliance burden. Payments are created via API and the customer completes authentication on a PayPlug-hosted page before the merchant receives confirmation.
Create a payment for 149.99 EUR via POST /v1/payments with a return URL and hosted_payment configuration, then retrieve the payment status
Installment Payment Plans
Offer customers the option to pay in 3 or 4 installments (paiement en plusieurs fois) for higher-value purchases. PayPlug manages the installment schedule, collects each payment automatically, and handles failures. This French-market feature increases conversion rates on expensive items by splitting the total across multiple monthly payments.
Create a 3-installment plan for 299.99 EUR via POST /v1/installment_plans and monitor the plan status via GET /v1/installment_plans/{installmentPlanId}
Automated Refund Processing
Issue refunds against completed PayPlug payments programmatically. The API supports both full refunds (refunding the entire payment amount) and partial refunds. Each refund is tracked independently and linked to the original payment for reconciliation.
Issue a partial refund of 25.00 EUR against payment ID pay_abc123 via POST /v1/payments/{paymentId}/refunds
AI Agent Payment Orchestration
AI agents use the PayPlug API through Jentic to process French payments, manage installment plans, and handle refunds without managing bearer token lifecycle or payment page flows directly. Jentic handles credential isolation and operation discovery for all 11 PayPlug endpoints.
Search Jentic for 'create a payment in France', load the PayPlug payment creation schema, and execute a 79.99 EUR card payment
Key Endpoints
11 endpoints — jentic publishes the only available openapi specification for payplug payments api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/v1/payments
Create a new payment
GET
/v1/payments/{paymentId}
Retrieve payment details
POST
/v1/payments/{paymentId}/refunds
Issue a refund
GET
/v1/payments/{paymentId}/refunds/{refundId}
Get refund details
GET
/v1/cards/{cardId}
Retrieve stored card details
POST
/v1/installment_plans
Create an installment plan
GET
/v1/installment_plans/{installmentPlanId}
Get installment plan status
POST
/v1/payments
Create a new payment
GET
/v1/payments/{paymentId}
Retrieve payment details
POST
/v1/payments/{paymentId}/refunds
Issue a refund
GET
/v1/payments/{paymentId}/refunds/{refundId}
Get refund details
GET
/v1/cards/{cardId}
Retrieve stored card details
POST
/v1/installment_plans
Create an installment plan
GET
/v1/installment_plans/{installmentPlanId}
Get installment plan status
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
PayPlug API secret keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — raw secret keys never enter the agent context.
Intent-based discovery
Agents search by intent (e.g., 'create an installment plan in France') and Jentic returns matching PayPlug operations with their input schemas, so the agent can call the right endpoint without browsing documentation.
Time to first call
Direct PayPlug integration: 2-3 days for auth setup, hosted page configuration, and webhook handling. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
Stripe
Global payment processor with French market support and broader feature set
Choose Stripe when you need global payment coverage, advanced subscription management, or more extensive developer tools beyond the French market.
FAQs
Specific to using PayPlug Payments API through Jentic.
Why is there no official OpenAPI spec for PayPlug Payments API?
PayPlug does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call PayPlug Payments API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the PayPlug Payments API use?
The PayPlug API uses Bearer token authentication with your secret API key sent in the Authorization header. Through Jentic, API keys are stored encrypted in the MAXsystem vault and agents receive scoped access without handling raw secret keys.
Can I offer installment payments (3x or 4x) with PayPlug?
Yes. The POST /v1/installment_plans endpoint creates a payment plan that splits the total amount across 3 or 4 monthly installments. PayPlug manages the collection schedule automatically and you can monitor progress via GET /v1/installment_plans/{installmentPlanId}.
How do I process a refund through Jentic?
Use Jentic to search for 'refund a PayPlug payment', load the schema for POST /v1/payments/{paymentId}/refunds, and execute with the refund amount. The response includes the refund ID and status. You can also retrieve refund details via GET /v1/payments/{paymentId}/refunds/{refundId}.
Does PayPlug support 3D Secure authentication?
Yes. PayPlug payments support 3D Secure (3DS) authentication for Strong Customer Authentication (SCA) compliance. When creating a payment via POST /v1/payments, you configure the hosted payment page which handles the 3DS challenge flow automatically.
Can I store customer cards for repeat purchases?
Yes. PayPlug stores card details securely and provides the GET /v1/cards/{cardId} endpoint to retrieve card information for returning customers. Stored cards can be used to create subsequent payments without the customer re-entering their card details.
GET STARTED