Partners

Partner MCP

Partner keys (pk_live_) are minted by Printonic admins and bound to a partner account. They can search gift-eligible products, create custom listings and gift sets, submit paid orders, cancel an order before production, read billing balance, and settle a negative balance.

printonic_cancel_order (REST POST /api/external/orders/{id}/cancel) cancels an order that has not been printed, labeled or shipped and refunds it to the wallet first, then the card. Pass preview: true (REST GET) to see the refund without canceling. Repeating the call on a canceled order answers already_canceled and never refunds twice.

Paid tools charge the partner wallet, then the card on file. They share idempotency with the REST Partner API so a retry cannot double-charge.

Keys with the team_orders capability also create corporate gifting team orders for a client (one bundle, many recipients, claim links, printed card, event date) and receive signed webhooks as every gift is claimed, shipped and delivered. Team orders and webhooks. A spreadsheet tool such as Clay sends one gift per row through the flat endpoint: Send gifts from Clay.

Partner REST reference