Membuat dan mengelola sub-akun

Di Merchant API, akun dapat memiliki hubungan sub-akun dengan akun lain. Anda dapat menggunakan Merchant Accounts API untuk membuat sub-akun baru di bagian akun tingkat lanjut. Anda harus memiliki akun lanjutan yang sudah ada untuk melakukan panggilan ini. Anda tidak dapat menggunakan Merchant API untuk memindahkan akun penjual mandiri yang sudah ada di akun Anda.

Penyedia pihak ketiga dapat menggunakan Merchant Accounts API untuk mengembangkan antarmuka yang memungkinkan penjual membuat dan mengelola detail akun mereka.

Membuat sub-akun

Untuk membuat sub-akun baru di akun tingkat lanjut, panggil accounts.createAndConfigure:

  1. Berikan detail sub-akun di kolom account.
  2. Tentukan pengguna baru yang diberi otorisasi di kolom users. Akses pengguna juga diwarisi dari akun induk.
  3. Tentukan accountAggregation di kolom service.

    Berikut adalah contoh untuk membuat sub-akun di akun account/123, yang adalah agregator untuk sub-akun:

    POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure
    
    {
      "account": {
        "accountName": "merchantStore",
        "adultContent": false,
        "testAccount": false,
        "timeZone": {
          "id": "America/New_York",
        }
        "languageCode": "en-US",
      },
      "service": [
        {
          "accountAggregation": {},
          "provider": "providers/123"
        }
      ]
    }
    

Contoh berikut menunjukkan cara menggunakan paket CreateAndConfigureAccountRequest untuk membuat sub-akun baru.

Java

  public static void createSubAccount(Config config) throws Exception {

    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    // Creates service settings using the credentials retrieved above.
    AccountsServiceSettings accountsServiceSettings =
        AccountsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    // Creates parent/provider to identify the MCA account into which to insert the subaccount.
    String parent = getParent(config.getAccountId().toString());

    // Calls the API and catches and prints any network failures/errors.
    try (AccountsServiceClient accountsServiceClient =
        AccountsServiceClient.create(accountsServiceSettings)) {

      CreateAndConfigureAccountRequest request =
          CreateAndConfigureAccountRequest.newBuilder()
              .setAccount(
                  Account.newBuilder()
                      .setAccountName("Demo Business")
                      .setAdultContent(false)
                      .setTimeZone(TimeZone.newBuilder().setId("America/New_York").build())
                      .setLanguageCode("en-US")
                      .build())
              .addService(
                  AddAccountService.newBuilder()
                      .setProvider(parent)
                      .setAccountAggregation(AccountAggregation.getDefaultInstance())
                      .build())
              .build();

      System.out.println("Sending Create SubAccount request");
      Account response = accountsServiceClient.createAndConfigureAccount(request);
      System.out.println("Inserted Account Name below");
      // Format: `accounts/{account}
      System.out.println(response.getName());
    } catch (Exception e) {
      System.out.println(e);
    }
  }

Setujui Persyaratan Layanan

Sub-akun mewarisi Persyaratan Layanan (TOS) Merchant Center yang ditandatangani akun induk.

Memperbarui informasi bisnis Anda

Anda dapat menggunakan Merchant Accounts API untuk mengedit informasi bisnis.