1. Simplified Payouts
Fintainium APIs
  • Overview
  • Quick Start
  • Use Cases
  • Recipies
    • Connect with Vendor
    • Pay a Vendor
  • API Reference
    • AP Payouts (Accounts Payable)
      • Vendor (Recipient)
        • Create new vendor
        • Update Vendor
        • View Vendor Details
      • Payments (Payouts)
        • Initiate Payment
        • Add Payment Method
      • Bills
        • Create new Bill
      • Country State City
        • GET City List by State Name/ID/Code
    • AR Collection (Accounts Receivable)
      • Invoices
        • Create new Invoice
      • Customers
        • Create new customer
      • Payment (Collection)
        • Initiate Payment
        • Add Payment Method
    • Simplified Payouts
      • Send Payouts
        POST
    • Transactions
      • Retrieve Transaction Status
    • Webhooks
      • Register for an Event
      • Get Webhook Registration Status
    • Sub-Ledger
      • Retrieve Balance
  1. Simplified Payouts

Send Payouts

POST
https://staginggateway.fintainium.com/gateway/api/payouts/batch
The Send Payouts (Simplified API) enables initiating single or multiple payouts in one call. Each payout automatically creates or updates the Recipient, records a Transaction, and sends an email invite to collect the Recipient’s preferred payout method.
For each successful payout:
Recipient Management: Create or update the Recipient (vendor).
Transaction Recording: Generate a Transaction associated with the payout.
Email Invitation: Send an email invite to the Recipient requesting their preferred payout method.
Supports both single and bulk payouts in a seamless, developer-friendly workflow.

Field: allowedPaymentMethods#

The allowedPaymentMethods field defines which payout methods are enabled for the transaction.
It accepts a comma-separated list of payment method codes, as shown below:
CodePayment MethodDescription
1001ACHStandard bank transfer to the recipient’s account.
1002CheckPhysical check payment mailed to the recipient’s address.
1003Rapid PayExpedited digital payment for faster fund delivery to recipient's debit/credit card linked to a bank account.
1004Virtual CardPayment via virtual card issued to the recipient for online or card-based use.
Example: "allowedPaymentMethods": "1001,1002,1003,1004"
The above example enables all supported payout methods for the transaction.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success
text/plain
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://staginggateway.fintainium.com/gateway/api/payouts/batch' \
--header 'sessionKey: YOUR_API_KEY_HERE' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessId": "3536331",
    "payout": [
        {
            "customerName": "Akil Test Vendor Aug 2005",
            "customerId":657878,
            "recipientFirstName": "Vexdor",
            "recipientLastName": "One",
            "recipientEmailAddress": "akil@vomoto.com",
            "recipientPhoneNumber": "1236547796",
            "recipientMode": "Open",
            "recipientAddressLine1": "300 WEST CUMMINGS PARK",
            "recipientAddressLine2": "Unit 254",
            "recipientZipCode": "92008",
            "recipientCountryCode": "US",
            "recipientStateCode": "NY",
            "recipientCity": "New York",
            "recipientInternalId": "VendorOne1",
            "allowedPaymentMethods": "1001,1002,1003,1004",
            "achFees": "1%",
            "rapidPayFees": 1.5,
            "checkFees": "2",
            "vcFees": "2%",
            "transactionId": "102493988",
            "recipientNote": "XYZ",
            "totalAmount": 200,
            "paymentDate": "2025-08-08",
            "customerLogo": "https://openclipart.org/image/800px/232064"
        }
    ]
}'
Response Response Example
{
    "businessId": "105481",
    "statusCode": 200,
    "actionCode": "00",
    "message": "1 Bills created successfully",
    "failedCount": 0,
    "failedMessageList": [],
    "successCount": 1,
    "transactions": [
        {
            "transactionId": "102493988",
            "totalAmount": 200.0,
            "fintainiumTransactionId": 4613303
        }
    ],
    "transmissionDateTime": "2025-08-08T03:45:11.719702-04:00"
}
Modified at 2025-10-21 15:40:26
Previous
Add Payment Method
Next
Retrieve Transaction Status
Built with