Skip to content

21. Balance Transfer API

Jump to bottom
Vincent Kok edited this page Dec 28, 2025 · 1 revision

This API endpoint allows you to create a balance transfer from your organization's balance to a connected organization's balance, or vice versa. You can also create a balance transfer between two connected organizations. To create a balance transfer, you must be authenticated as the source organization, and the destination organization must be a connected organization that has authorized the balance-transfers.write scope for your organization.

Create a balance transfer request

BalanceTransferRequest request = new() {
	Description = "Test Description",
	Amount = new Amount(Currency.EUR, 50),
	Source = new BalanceTransferParty {
		Id = "source",
		Description = "Test Source",
		Type = "organization"
	},
	Destination = new BalanceTransferParty {
		Id = "destination",
		Description = "Test Destination",
		Type = "organization"
	}
};
using var balanceTransferClient = new BalanceTransferClient({yourOAuthToken});
BalanceTransferResponse response = await balanceTransferClient.CreateBalanceTransferAsync(request);

List balance transfers

using var balanceTransferClient = new BalanceTransferClient({yourOAuthToken});
ListResponse<BalanceTransferResponse> response = await balanceTransferClient.CreateBalanceTransferAsync(testmode: true/false);

Get a balance transfer by id

using var balanceTransferClient = new BalanceTransferClient({yourOAuthToken});
BalanceTransferResponse response = await balanceTransferClient.GetBalanceTransferAsync({yourBalanceTransferId});

Clone this wiki locally