Add Funds to Your Balance

Save a payment method on your account

Create a top up from the Dashboard, or save a card through the API with Create setup intent and owner_id set to your account ID. Either saves a payment method on your account that you can reuse programmatically.

Get payment methods

List saved payment methods for your account:

const paymentMethods = await client.paymentMethods.list({
  company_id: "biz_xxxxxxxxxxxxx",
});

const paymentMethod = paymentMethods.data[0];

payment_methods = client.payment_methods.list(
    company_id="biz_xxxxxxxxxxxxx",
)

payment_method = payment_methods.items[0]

let payment_methods = client
    .payment_methods
    .list(
        &PaymentMethodsListQueryRequest {
            company_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

let payment_method = &payment_methods.data[0];
println!("{payment_method:?}");

page, err := client.PaymentMethods.List(context.TODO(), &whopsdk.ListPaymentMethodsRequest{
    CompanyID: whopsdk.String("biz_xxxxxxxxxxxxx"),
})
if err != nil {
    log.Fatal(err)
}

paymentMethod := page.Results[0]
fmt.Println(paymentMethod)

Create a top up

Create a deposit to your account and pass the saved payment method to charge:

const deposit = await client.deposits.create({
  destination: "biz_xxxxxxxxxxxxx",
  amount: 1000.0,
  payment_method_id: paymentMethod.id,
});

console.log(deposit.methods.card?.payment_id);

deposit = client.deposits.create(
    destination="biz_xxxxxxxxxxxxx",
    amount=1000.0,
    payment_method_id=payment_method.id,
)

print(deposit.methods.card.payment_id)

In this example:

destination is your platform’s account ID
amount is the amount in USD to add to your balance
payment_method_id is the saved payment method to charge

The response’s methods.card.payment_id is the payment the charge created. The request needs an API key with the payment:charge scope.

Handle payment events

Listen for payment webhooks to confirm the top up was successful:

if (webhookData.type === "payment.succeeded") {
  const payment = webhookData.data;
  console.log("Top up successful:", payment.id);
}

if (webhookData.type === "payment.failed") {
  const payment = webhookData.data;
  console.log("Top up failed:", payment.failure_message);
}

Collect payments for connected accounts

Transfer funds to connected accounts

Render payout portal

Let users withdraw their funds

​Related resources

Collect payments for connected accounts

Render payout portal

Related resources