Pay.nl Transaction Gateway API

Partial Refund Processing

Process full or partial refunds for customer returns and cancellations using the refund endpoints. PATCH /orders/{id}/refund issues a full refund, while PATCH /orders/{id}/refund-amount allows specifying the exact amount to return. PATCH /orders/{id}/refund-products enables product-level granularity by refunding specific line items and quantities. Each refund can include a description field for internal tracking and customer communication.

Pre-Authorization and Capture Workflow

Implement a two-stage payment flow where authorization happens at order time but capture occurs only after fulfillment. Create the order with POST /orders including testMode: false for production. The order enters an authorized state. When goods ship or services complete, call PATCH /orders/{id}/capture-products to capture only the items being fulfilled, useful for partial shipments. Monitor status via GET /orders/{id}/status to ensure the capture succeeded before finalizing the order.

Fraud Prevention and Order Approval

Implement manual order review for high-risk transactions using the approve and decline endpoints. After order creation, orders flagged by internal fraud systems can remain in pending state. Use PATCH /orders/{id}/approve to allow legitimate orders to proceed or PATCH /orders/{id}/decline to cancel suspicious transactions. PATCH /orders/{id}/void provides an additional mechanism to cancel orders before capture. Combined with GET /orders/{id}/status, this enables human-in-the-loop fraud review workflows.

AI Agent for Payment Operations

Let an AI agent handle routine payment operations for an e-commerce platform — creating orders at checkout, capturing payments post-fulfillment, processing refunds for returns, and checking order status for customer service inquiries. Through Jentic, the agent loads only the specific payment operations it needs and credentials are injected securely without appearing in prompts.