Fat Zebra Pin Payments API

Recurring Subscription Billing

Bill customers on recurring schedules for SaaS products, memberships, and services. First create a Plan defining the billing amount and interval (weekly, monthly, yearly), then create a Subscription linking a customer token to the plan. Pin Payments automatically generates charges at each billing cycle, handles failed payments with retry logic, and tracks subscription state (trial, active, cancelled). The Ledger endpoint provides complete transaction history for each subscription. Agents can set up subscriptions through Jentic by searching for 'create subscription' and receiving the required schema.

Marketplace Payment Splits

Distribute funds to multiple recipients in platform and marketplace applications. The Recipients API stores bank account details for each seller, and the Transfers API moves funds from the platform's Pin Payments balance to recipient bank accounts. This enables gig-economy platforms, peer-to-peer marketplaces, and multi-vendor e-commerce sites to automate seller payouts while retaining a platform fee. The Balance and Deposits APIs provide reconciliation data for accounting. AI agents can orchestrate these flows through Jentic without directly handling bank account data.

Agent-Driven Payment Automation via Jentic

AI agents discover and execute Pin Payments operations through Jentic's intent-based API search without managing API keys or parsing documentation. An agent receives a request like 'process a $50 payment for customer@example.com' and searches Jentic for 'create a charge'. Jentic returns the POST /1/charges schema with required fields pre-shaped for execution. The agent provides customer email, amount, description, and card token; Jentic injects the API key at runtime and returns the charge result. This reduces Pin Payments integration from days to minutes and keeps sensitive credentials out of agent context.