Companies (Admin)

Companies informations inside W3block ecosystem is maintained by the ID service. Here, you can only change companies configurations about the commerce service. Available configurations:

• Payment providers: You can enable and configure some available payment providers such as paypal, pagar.me and stripe.

• Deliver delays: You can configure how much time you want to wait until transfer token to the client/user after the payment was approved. This is very useful since credit card payments can be easier cancelled 3 days after payment was completed. You can specify that for each payment type as PIX, credit card, or transfer.

• Logo: You can change company logo from our lightweight commerce front-end

• Banners: You can change home-page banners from our lightweight commerce front-end

Payment

1. Payment Distribution (Fees and income)

Every order transaction is divided in 3 parts:

• Service Fee: This fee is the W3Block transaction part, it can be paid from client, company or both depending of the W3Block contract

• Gas Fee: This fee is used to pay blockchain transactions under the tokens transfer

• Company Income: Is the rest of the money that will be directly transferred to the company

2. Payment Splitting to Separate Service Fee, Gas Fee and Company Income

Stripe payment provider has a native payment splitting functionality which transfer to W3block the service fee and transactions gas fees automatically without the need of the company to receive and/or declare that income.

Other payment providers can also offer that functionality, but that's under construction

Company Configuration Model (Example)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "createdAt": "2022-11-03T22:33:20.215Z",
  "updatedAt": "2022-11-03T22:33:20.215Z",
  "companyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "company": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "createdAt": "2022-11-03T22:33:20.215Z",
    "updatedAt": "2022-11-03T22:33:20.215Z",
    "name": "W3Block testing company"
  },
  "banners": [
    {
      "text": "Banner description",
      "buttonText": "Click",
      "buttonLink": "https://w3block.io",
      "image": {
        "thumb": "https://dummyimage.com/200x200/fff/000",
        "original": "https://dummyimage.com/600x400/fff/000",
        "assetId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      }
    }
  ],
  "deliveryDelays": [
    {
      "paymentMethod": "credit_card",
      "delay": 259200000
    }
  ],
  "domain": "string",
  "logo": "string",
  "operatorWalletAddress": "string",
  "paymentProviders": [],
  "clientServiceFeePercentage": 0,
  "companyServiceFeePercentage": 0
}

Service Methods

Gets company configurations

Using SDK

// init your sdk as defined in main page of Commerce service
import { W3blockCommerceSDK } from '@w3block/sdk-commerce';
const sdk: W3blockCommerceSDK;
...

const companyId = '<Your companyId/TenantId>';
const configurations = await sdk.api.admin.getCompanyConfigurations(companyId);
console.log('configurations', configurations);

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Updates some company configurations

Using SDK

// init your sdk as defined in main page of Commerce service
import { W3blockCommerceSDK, PaymentMethod } from '@w3block/sdk-commerce';
const sdk: W3blockCommerceSDK;
...

const companyId = '<Your companyId/TenantId>';
await sdk.api.admin.updateCompanyConfigurations(companyId, {
      deliverDelays: [
            {
                  paymentMethod: PaymentMethod.CreditCard,
                  delay: 0,
            }
      ],
});

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Set a specific payment provider to be used into some currency

Using SDK

// init your sdk as defined in main page of Commerce service
import { W3blockCommerceSDK, PaymentProviderEnum } from '@w3block/sdk-commerce';
const sdk: W3blockCommerceSDK;
...

const companyId = '<Your companyId/TenantId>';
const currencyId = '<currencyId>';
await sdk.api.admin.setCompanyCurrencyPaymentProvider(companyId, currencyId, {
      paymentProvider: PaymentProviderEnum.Stripe
});

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Configures Pagar.me payment provider

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Configures Paypal payment provider

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Request Stripe payment provider configuration

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Finish stripe payment provider configuration

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Refresh stripe payment provider configuration

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

Deletes some payment provider configuration

Rest API reference:

Error while loading OpenAPI operation — Failed to fetch OpenAPI file