Marketplace: members, commission and payouts

# An organization key (an admin's), in the key's mode. holdFunds holds their payments until you# trust them; organizationFeePercent is your commission. The link is also emailed ("sendEmail":# false to share it yourself): they are a member once they accepted (the member.joined webhook).curl https://api.qbitflow.app/v2/invitations \  -H "X-API-Key: $QBITFLOW_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{    "email": "seller@example.com",    "role": "user",    "holdFunds": true,    "organizationFeePercent": "10",    "redirectUrl": "https://shop.example.com/sellers/welcome"  }'# 201: a CreatedInvitation: the invitation's fields and "link", the link to accept

const created = await client.invitations.create({	email: 'seller@example.com',	holdFunds: true, // hold their payments until you trust them (always sent)	organizationFeePercent: '10', // your commission on their payments: '0' to '50' %	redirectUrl: 'https://shop.example.com/sellers/welcome',});// QBitFlow also emails them a link of their own. They are a member once they accepted (the// member.joined webhook).console.log(`invitation ${created.uuid}: ${created.link}`);

created = client.invitations.create(    email="seller@example.com",    hold_funds=True,  # hold their payments until you trust them (always sent)    organization_fee_percent="10",  # your commission on their payments: "0" to "50" %    redirect_url="https://shop.example.com/sellers/welcome",)# The seller exists once they accept: wait for the member.joined webhook.# created.uuid is what member.joined's invitation_uuid names; its user_uuid is the seller.# QBitFlow also emails them a link of their own.print("invitation", created.uuid, "link:", created.link)

created, err := client.Invitations.Create(ctx, &qbitflow.CreateInvitationParams{	Email:                  "seller@example.com",	HoldFunds:              true, // hold their payments until Members.Trust (always sent)	OrganizationFeePercent: "10", // your commission on their payments: "0" to "50" %	RedirectURL:            "https://shop.example.com/sellers/welcome",})if err != nil {	log.Fatal(err) // 409 already_joined for a member}// QBitFlow also emails the seller a link of their own. The seller exists once they// accepted: wait for member.joined.fmt.Println("invitation", created.UUID, "link:", created.Link)

$created = $client->invitations->create(new \QBitFlow\Params\CreateInvitationParams(	email: 'seller@example.com',	holdFunds: true,              // hold their payments until you trust them (always sent)	organizationFeePercent: '10', // your commission on their payments: "0" to "50" %	redirectUrl: 'https://shop.example.com/sellers/welcome',));// QBitFlow also emails them a link of their own.echo "Invitation {$created->uuid}: {$created->link}\n";

# What the organization holds for its members (their payments while untrusted), the longest held# first. One member's lines: GET /members/$MEMBER_UUID/held-funds.curl https://api.qbitflow.app/v2/members/held-funds \  -H "X-API-Key: $QBITFLOW_API_KEY"# 200: [ { "userUuid": "…", "totalAmount": 98.35, "count": 2, "oldestAt": "…" } ]

// What the organization holds for its members (their payments while untrusted), the longest// held first.const all = await client.members.listHeldFunds();for (const owed of all) {	console.log(`${owed.userUuid}: ${owed.totalUsd} USD owed over ${owed.count} lines`);} const held = await client.members.getHeldFunds(memberUuid);for (const ledger of held.ledgers) {	// owed: what the line counts for in a release (negative for a refund).	console.log(		`  ${ledger.type} ${ledger.owed} ${ledger.currency.symbol} (${ledger.owedUsd} USD)`	);}console.log(`held for this member: ${held.totalUsd} USD`);

# Every member you hold funds for, the longest held first.for summary in client.members.list_held_funds():    print(summary.user_uuid, f"{summary.total_usd} USD over {summary.count} lines") held = client.members.get_held_funds(member_uuid)  # one member, line by lineprint(f"owed to the seller: {held.total_usd} USD over {len(held.ledgers)} lines")

// What the organization holds for its members (their payments while untrusted).// The longest held first.all, err := client.Members.ListHeldFunds(ctx)if err != nil {	log.Fatal(err)}for _, s := range all {	fmt.Printf("%s: %s USD over %d lines\n", s.UserUUID, s.TotalUSD, s.Count)} held, err := client.Members.GetHeldFunds(ctx, memberUUID)if err != nil {	log.Fatal(err)}fmt.Printf("owed to %s: %s USD over %d lines\n", memberUUID, held.TotalUSD, len(held.Ledgers))

foreach ($client->members->listHeldFunds() as $owed) { // every member you owe, the longest held first	echo "{$owed->userUuid}: {$owed->totalUsd} USD over {$owed->count} lines\n";} $held = $client->members->getHeldFunds($memberUuid);printf("Owed to %s: %s USD over %d lines\n", $memberUuid, $held->totalUsd, count($held->ledgers));