Payout Service Overview

Overview

The Payout Service enables you to send funds to recipients using the Java SDK. Use this for marketplace payouts, refunds to bank accounts, supplier payments, and other fund disbursement needs.

Business Use Cases:

• Marketplace payouts - Pay sellers/merchants on your platform

• Supplier payments - Disburse funds to vendors and suppliers

• Payroll - Employee and contractor payments

• Instant payouts - Same-day transfers to connected accounts

Operations

Operation	Description	Use When
create	Create a payout. Initiates fund transfer to recipient.	Sending money to a recipient
transfer	Create a payout fund transfer. Move funds between accounts.	Transferring between internal accounts
get	Retrieve payout details. Check status and tracking.	Monitoring payout progress
void	Cancel a pending payout. Stop before processing.	Aborting an incorrect payout
stage	Stage a payout for later processing. Prepare without sending.	Delayed payouts, batch processing
createLink	Create link between recipient and payout. Associate payout with recipient.	Setting up recipient relationships
createRecipient	Create payout recipient. Store recipient bank/payment details.	First time paying a new recipient
enrollDisburseAccount	Enroll disburse account. Set up account for payouts.	Onboarding new payout accounts

SDK Setup

import com.hyperswitch.prism.PayoutClient;

PayoutClient payoutClient = PayoutClient.builder()
    .connector("stripe")
    .apiKey("YOUR_API_KEY")
    .environment("SANDBOX")
    .build();

Payout Methods

Method	Speed	Typical Use
Bank transfer	1-3 business days	Standard payouts, large amounts
Instant transfer	Minutes	Same-day needs, existing recipients
Card payout	Instant	Prepaid cards, debit cards

Next Steps

• createRecipient - Set up your first recipient

• create - Send your first payout

• Event Service - Handle payout webhooks