Openpay

BBVA-owned Mexican gateway — the MX alternative to Conekta. Cards, OXXO, SPEI, subscriptions (native), marketplace payouts. Closes the BBVA-rail story for Mexico.

MIT · runs locally with your own credentials

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Tools

What your agent can call.

Create a charge. Pass customer_id to charge at a customer scope (POST /customers/{customer_id}/charges); omit to charge at merchant scope (POST /charges). Methods: 'card' (requires source_id token), 'bank_account' (SPEI — returns CLABE reference), 'store' (OXXO — returns barcode/reference). Amounts are in major units (e.g. 100 = 100 MXN).

Retrieve a charge. Pass customer_id to fetch at customer scope (GET /customers/{customer_id}/charges/{id}); omit for merchant scope (GET /charges/{id}).

Capture a previously authorized charge (when the original charge used capture=false). Pass amount to capture less than the authorized total; omit to capture the full authorized amount.

Refund a captured charge. Supports partial refunds via amount; omit amount for a full refund.

Create a customer record. Set requires_account=true to create an associated Openpay wallet for the customer; false for a payment-only record.

Retrieve a customer by Openpay customer id.

List customers with optional filters. All parameters are passed as query params.

Tokenize a card. Pass customer_id to attach to a stored customer (POST /customers/{customer_id}/cards); omit for a merchant-level token (POST /cards). Prefer tokenizing client-side with Openpay.js to avoid PCI scope.

Delete a tokenized card. Pass customer_id to delete at customer scope (DELETE /customers/{customer_id}/cards/{id}); omit for merchant scope (DELETE /cards/{id}).

Create a subscription plan. Plans are templates — use create_subscription to subscribe a customer.

Subscribe a customer to a plan. Requires a stored card (source_id) to charge on each cycle.

Pay out MXN to a bank account. Used for marketplace seller payouts and cross-border settlement. Scope to a customer with customer_id (POST /customers/{customer_id}/payouts) or run at merchant scope (POST /payouts).

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio · streamable-http.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.