Transfers

Create Batch Transfer

Code
 
const batchTransfer = await saligpay.transfers.create({
    transfers: [
        {
            source_account: {
                number: "1234567890",
                name: "Merchant Account",
                bic: "BNORPHMM",
            },
            destination_account: {
                number: "0987654321",
                name: "Partner Account",
                bic: "BNORPHMM",
            },
            amount: 100000,
            currency: "PHP",
            provider: "instapay",
            reference_number: "BATCH-001",
            purpose: "settlement",
            description: "Partner payment for May 2025",
            metadata: { partnerId: "partner_123" },
        },
    ],
});

List Transfers

Code
 
const transfers = await saligpay.transfers.list({
    limit: 20,
    description: "settlement",
});

Get Transfer Details

Code
 
const transfer = await saligpay.transfers.get("tr_xyz789");

Transfer Response Types

Code
 
interface Transfer {
    id: string;
    livemode: boolean;
    merchant_id: string;
    source_account: TransferAccount;
    destination_account: TransferAccount;
    amount: number;
    fee: number;
    currency: string;
    provider: "paymongo" | "instapay" | "pesonet";
    status: "pending" | "succeeded" | "failed";
    reference_number?: string;
    purpose?: string;
    description?: string;
    provider_reference_number?: string;
    callback_url?: string;
    metadata?: Record<string, unknown>;
    batch_transfer_id: string;
    created_at: string;
    updated_at: string;
}

interface TransferAccount {
    number: string;
    name: string;
    bic?: string;
}

interface BatchTransfer {
    id: string;
    transfers: Transfer[];
}

interface TransferListResult {
    has_more: boolean;
    data: Transfer[];
}