Onboard merchants/
Create merchant accounts/
Sample account creation requests

Sample account creation requests

DocsCURRENT

Last updated: Oct 7th, 12:32am

Note: The Managed Accounts API has been recently updated, to view the previous version of sample account creation requests see Sample Account Creation Requests Deprecated.

There are different requirements for creating accounts for merchants in the United States, the European Union, Australia, Canada, Indonesia, Japan, and the United Arab Emirates. This page provides examples of sample requests that you can use to create accounts for the following countries and business types.

United States

Sample requests

  1. Corporation
  2. Individual
  3. Nonprofit
  4. Private Corporation
  5. Proprietorship
  6. Public Company
  7. Government
1{
2    "external_id": "EXTERNAL-ID",
3    "legal_country_code": "US",
4    "organization": "us",
5    "user_id": "USER-ID",
6    "primary_currency_code": "USD",
7    "individual_owners": [
8        {
9            "names": [
10                {
11                    "type": "LEGAL",
12                    "given_name": "MaryAPPROVED",
13                    "surname": "Collins"
14                }
15            ],
16            "citizenship": "US",
17            "emails": [
18                {
19                    "email": "[email protected]"
20                }
21            ],
22            "phone_numbers": [
23                {
24                    "country_code": "1",
25                    "national_number": "33333333",
26                    "extension_number": "1",
27                    "type": "MOBILE"
28                }
29            ],
30            "birth_details": {
31                "date_of_birth": "2021-09-16"
32            },
33            "primary_residence": {
34                "address_line_1": "123 Main St",
35                "address_line_2": "add primary residence",
36                "admin_area_2": "Anytown",
37                "admin_area_1": "CA",
38                "postal_code": "12345",
39                "country_code": "US"
40            },
41            "identification_documents": [
42                {
43                    "type": "INDIVIDUAL_TAX_IDENTIFICATION_NUMBER",
44                    "identification_number": "923456789",
45                    "issuing_country_code": "US"
46                }
47            ]
48        }
49    ],
50    "business_entity": {
51        "type": "CORPORATION",
52        "merchant_category_code": "5932",
53        "website_info": {
54            "website_exists": true,
55            "website_url": "https://www.standardpartner.com"
56        },
57        "names": [
58            {
59                "type": "LEGAL",
60                "business_name": "MaryAPPROVED Inc."
61            }
62        ],
63        "registered_business_address": {
64            "address_line_1": "456 Main St",
65            "admin_area_1": "CA",
66            "admin_area_2": "Anytown",
67            "postal_code": "12345",
68            "country_code": "US"
69        },
70        "identification_documents": [
71            {
72                "type": "EMPLOYER_IDENTIFICATION_NUMBER",
73                "identification_number": "729265100",
74                "issuing_country_code": "US"
75            }
76        ],
77        "phone_numbers": [
78            {
79                "type": "BUSINESS",
80                "country_code": "27",
81                "national_number": "06151172"
82            }
83        ],
84        "emails": [
85            {
86                "email": "[email protected]"
87            }
88        ],
89        "beneficial_owners": {
90            "individuals": [
91                {
92                    "percentage_of_ownership": "35",
93                    "names": [
94                        {
95                            "type": "LEGAL",
96                            "given_name": "BillAPPROVED",
97                            "surname": "Smoth"
98                        }
99                    ],
100                    "birth_details": {
101                        "date_of_birth": "1995-05-30"
102                    },
103                    "addresses": [
104                        {
105                            "type": "HOME",
106                            "admin_area_1": "CA",
107                            "address_line_1": "APPROVED 123 Main Street",
108                            "admin_area_2": "100",
109                            "postal_code": "12345",
110                            "country_code": "US"
111                        }
112                    ],
113                    "citizenship": "US",
114                    "identification_documents": [
115                        {
116                            "type": "SOCIAL_SECURITY_NUMBER",
117                            "identification_number": "123456789",
118                            "issuing_country_code": "US"
119                        }
120                    ],
121                    "phone_numbers": [
122                        {
123                            "country_code": "1",
124                            "national_number": "33333333",
125                            "extension_number": "1",
126                            "type": "WORK"
127                        }
128                    ],
129                    "emails": [
130                        {
131                            "email": "[email protected]"
132                        }
133                    ]
134                }
135            ]
136        },
137        "office_bearers": [
138            {
139                "names": [
140                    {
141                        "type": "LEGAL",
142                        "prefix": "Mr.",
143                        "given_name": "MaryAPPROVED",
144                        "surname": "Davis",
145                        "suffix": "Sr"
146                    }
147                ],
148                "citizenship": "US",
149                "addresses": [
150                    {
151                        "type": "HOME",
152                        "admin_area_1": "CA",
153                        "address_line_1": "APPROVED 123 Main St",
154                        "admin_area_2": "100",
155                        "postal_code": "12345",
156                        "country_code": "US"
157                    }
158                ],
159                "birth_details": {
160                    "date_of_birth": "1995-05-30"
161                },
162                "identification_documents": [
163                    {
164                        "type": "SOCIAL_SECURITY_NUMBER",
165                        "identification_number": "111222343",
166                        "issuing_country_code": "US"
167                    }
168                ],
169                "phone_numbers": [
170                    {
171                        "country_code": "1",
172                        "national_number": "33333333",
173                        "extension_number": "1",
174                        "type": "WORK"
175                    }
176                ],
177                "emails": [
178                    {
179                        "email": "[email protected]"
180                    }
181                ]
182            }
183        ]
184    },
185    "agreements": [
186        {
187            "type": "TERMS_ACCEPTED",
188            "accepted_time": "2022-06-02T01:23:45Z"
189        }
190    ]
191}

European Union

Sample requests

  1. Corporation
  2. Individual
  3. Nonprofit
  4. Proprietorship
  5. Public Company
  6. Government
  7. Public Corporation
1{
2            "external_id": "EXT-{{currentTime}}",
3            "legal_country_code": "GB",
4            "organization": "eu/gb/ads",
5            "user_id": "{{currentTime}}",
6            "primary_currency_code": "EUR",
7            "individual_owners": [
8                {
9                    "names": [
10                        {
11                            "type": "LEGAL",
12                            "given_name": "Mary",
13                            "surname": "Collins"
14                        }
15                    ],
16                    "addresses": [
17                        {
18                        "type": "HOME",
19                        "address_line_1": "62 Jedburgh Road",
20                        "admin_area_2": "LENCHWICK",
21                        "postal_code": "WR11 0XJ",
22                        "country_code": "GB"
23                        }
24                    ],
25                    "citizenship": "GB",
26                    "birth_details": {
27                        "date_of_birth": "1990-01-01"
28                    }
29                }
30            ],
31            "business_entity": {
32                "type": "CORPORATION",
33                "merchant_category_code": "5931",
34                "names": [
35                    {
36                        "type": "LEGAL",
37                        "business_name": "Demo Inc."
38                    }
39                ],
40                "addresses": [
41                    {
42                        "type": "BUSINESS",
43                        "address_line_1": "62 Jedburgh Road",
44                        "admin_area_2": "LENCHWICK",
45                        "postal_code": "WR11 0XJ",
46                        "country_code": "GB"
47                    }
48                ],
49                "incorporation_details": {
50                    "date_of_incorporation": "2004-07-29",
51                    "incorporation_country_code": "GB"
52                },
53                "identification_documents": [
54                    {
55                        "type": "BUSINESS_REGISTRATION_NUMBER",
56                        "identification_number": "1234567890",
57                        "issuing_country_code": "GB"
58                    }
59                ],
60                "beneficial_owners": {
61                    "individuals": [
62                        {
63                            "percentage_of_ownership": "55",
64                            "names": [
65                                {
66                                "type": "LEGAL",
67                                "given_name": "James",
68                                "surname": "Collins",
69                                "suffix": "Jr"
70                                }
71                            ],
72                            "citizenship": "GB",
73                            "addresses": [
74                                {
75                                "type": "HOME",
76                                "address_line_1": "62 Jedburgh Road",
77                                "admin_area_2": "LENCHWICK",
78                                "postal_code": "WR11 0XJ",
79                                "country_code": "GB"
80                                }
81                            ],
82                            "birth_details": {
83                                "date_of_birth": "1985-01-01"
84                            }
85                        }
86                    ]
87                },
88                "office_bearers": [
89                {
90                    "role": "DIRECTOR",
91                    "names": [
92                    {
93                        "type": "LEGAL",
94                        "prefix": "Mr.",
95                        "given_name": "Steve",
96                        "surname": "Collins",
97                        "suffix": "Sr"
98                    }
99                    ],
100                    "citizenship": "GB",
101                    "addresses": [
102                    {
103                        "type": "HOME",
104                        "address_line_1": "62 Jedburgh Road",
105                        "admin_area_2": "LENCHWICK",
106                        "postal_code": "WR11 0XJ",
107                        "country_code": "GB"
108                    }
109                    ],
110                    "birth_details": {
111                    "date_of_birth": "1990-01-01"
112                    }
113                }
114                ]
115            },
116            "agreements": [
117                {
118                    "type": "TERMS_ACCEPTED",
119                    "accepted_time": "2022-01-01T10:30:02Z"
120                }
121            ]
122        }

Australia

Sample requests

  1. Corporation
  2. Individual
  3. Nonprofit
  4. Proprietorship
  5. Public Company
  6. Government
  7. Public Corporation
1{
2            "external_id": "EXT-{{currentTime}}",
3            "legal_country_code": "AU",
4            "organization": "au/instagram",
5            "user_id": "{{currentTime}}",
6            "primary_currency_code": "AUD",
7            "individual_owners": [
8                {
9                    "names": [
10                        {
11                            "type": "LEGAL",
12                            "given_name": "Mary",
13                            "surname": "Collins"
14                        }
15                    ]
16                }
17            ],
18            "business_entity": {
19                "type": "CORPORATION",
20                "names": [
21                    {
22                        "type": "LEGAL",
23                        "business_name": "Demo Inc."
24                    }
25                ]
26            },
27            "agreements": [
28                {
29                    "type": "TERMS_ACCEPTED",
30                    "accepted_time": "2022-01-01T10:30:02Z"
31                }
32            ]
33        }

Canada

The following sample requests and responses show the account creation examples for different business types in Canada.

Additionally, the sample requests highlight the different use-case scenarios for business entities of type CORPORATION, along with the required roles and conditions for each case. For more information, see Use-case scenarios—Corporation type.

Sample requests

  1. Individual
  2. Nonprofit
  3. Government
  4. Corp - Owner matches roles
  5. Corp - Owner does not match roles
  6. Corp - >25% Beneficial Owner
  7. Corp - Complete data
1{
2    "external_id": "EXT-{{$randomAlphaNumeric}}",
3    "legal_country_code": "CA",
4    "organization": "{{organization}}",
5    "user_id": "{{currentTime}}",
6    "primary_currency_code": "CAD",
7    "individual_owners": [
8        {
9            "occupation": "Engineer",
10            "names": [
11                {
12                    "type": "LEGAL",
13                    "given_name": "LevinAPPROVED",
14                    "surname": "LevinAPPROVED"
15                }
16            ],
17            "birth_details": {
18                "date_of_birth": "1995-05-30"
19            },
20            "primary_residence": {
21                "type": "HOME",
22                "address_line_1": "1200-475 Howe St",
23                "admin_area_2": "Vancouver B.C",
24                "postal_code": "V6C 2B3",
25                "country_code": "CA"
26            },
27            "phone_numbers": [
28                {
29                    "country_code": "1",
30                    "national_number": "6692076750",
31                    "type": "MOBILE"
32                }
33            ]
34        }
35    ],
36    "business_entity": {
37        "declarations": [
38            {
39                "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
40                "value": "NO"
41            }
42        ],
43        "phone_numbers": [
44            {
45                "type": "BUSINESS",
46                "country_code": "1",
47                "national_number": "06151188"
48            }
49        ],
50        "type": "INDIVIDUAL",
51        "merchant_category_code": 5933,
52        "names": [
53            {
54                "type": "LEGAL",
55                "business_name": "Levin's Business"
56            }
57        ]
58    },
59    "agreements": [
60        {
61            "type": "TERMS_ACCEPTED",
62            "accepted_time": "2019-06-02T01:23:45Z"
63        }
64    ]
65}

Use-case scenarios - Corporation type

The following section lists the required roles and conditions for each CORPORATION business entity use case.

Required roles and conditions

individual_owner name matches with one of the following roles:

  • Business beneficial owner
  • Authorized representative

LOA (Letter of Authorization) is not required.

Sample responses

  1. Individual
  2. Nonprofit
  3. Government
  4. Corp - Owner matches roles
  5. Corp - Owner does not match roles
  6. Corp - >25% Beneficial Owner
  7. Corp - Complete data
1{
2    "account_id": "D4H2M7V6BGEB6",
3    "legal_country_code": "CA",
4    "individual_owners": [
5        {
6            "id": "D4H2M7V6BGEB6",
7            "names": [
8                {
9                    "given_name": "LevinAPPROVED",
10                    "surname": "LevinAPPROVED",
11                    "id": "V36XYTALSZLDN",
12                    "type": "LEGAL"
13                }
14            ],
15            "primary_residence": {
16                "address_line_1": "1200-475 Howe St",
17                "admin_area_2": "Vancouver B.C",
18                "postal_code": "V6C 2B3",
19                "country_code": "CA"
20            },
21            "phone_numbers": [
22                {
23                    "country_code": "1",
24                    "national_number": "6692076750",
25                    "id": "JCGKMUZ5DBRUJ",
26                    "type": "MOBILE"
27                }
28            ],
29            "birth_details": {
30                "date_of_birth": "1995-05-30"
31            },
32            "occupation": "Engineer"
33        }
34    ],
35    "business_entity": {
36        "type": "INDIVIDUAL",
37        "merchant_category_code": "5933",
38        "incorporation_details": {},
39        "names": [
40            {
41                "business_name": "Levin's Business",
42                "id": "9ZVN4SDRC4V74",
43                "type": "LEGAL"
44            }
45        ],
46        "phone_numbers": [
47            {
48                "country_code": "1",
49                "national_number": "06151188",
50                "id": "RZBFTEQSSJFAG",
51                "type": "BUSINESS"
52            }
53        ],
54        "declarations": [
55            {
56                "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
57                "value": "NO"
58            }
59        ]
60    },
61    "agreements": [
62        {
63            "type": "TERMS_ACCEPTED",
64            "accepted_time": "2019-06-02T01:23:45Z"
65        }
66    ],
67    "external_id": "EXT-s",
68    "organization": "ca",
69    "user_id": "1756241724454",
70    "primary_currency_code": "CAD",
71    "soft_descriptor": "LEVINSBUSIN",
72    "capabilities": [
73        {
74            "name": "APPLE_PAY",
75            "limits": [
76                {
77                    "type": "AMOUNT",
78                    "unit": "CAD",
79                    "value": "3000.00",
80                    "remaining_value": "3000.00",
81                    "implication_of_limit_breach": "START_GRACE_PERIOD"
82                }
83            ],
84            "grace_periods": [
85                {
86                    "start_time": "2025-09-24T21:40:31.000Z",
87                    "expiry_time": "2025-10-24T21:40:31.000Z"
88                }
89            ],
90            "status": "ACTIVE"
91        },
92        {
93            "name": "RECEIVE_MONEY",
94            "status": "ACTIVE"
95        },
96        {
97            "name": "CUSTOM_CARD_PROCESSING",
98            "limits": [
99                {
100                    "type": "AMOUNT",
101                    "unit": "CAD",
102                    "value": "3000.00",
103                    "remaining_value": "3000.00",
104                    "implication_of_limit_breach": "START_GRACE_PERIOD"
105                }
106            ],
107            "grace_periods": [
108                {
109                    "start_time": "2025-09-24T21:40:31.000Z",
110                    "expiry_time": "2025-10-24T21:40:31.000Z"
111                }
112            ],
113            "status": "ACTIVE"
114        },
115        {
116            "name": "PAYPAL_WALLET_VAULTING_ADVANCED",
117            "status": "NEED_DATA"
118        },
119        {
120            "name": "WITHDRAW_MONEY",
121            "status": "ACTIVE"
122        }
123    ],
124    "process_view": {
125        "processes": [
126            {
127                "name": "MANAGED_PATH_KYC_VERIFICATION",
128                "status": "NEED_MORE_DATA",
129                "capabilities": [
130                    {
131                        "name": "APPLE_PAY",
132                        "limits": [
133                            {
134                                "type": "AMOUNT",
135                                "unit": "CAD",
136                                "value": "3000.00",
137                                "remaining_value": "3000.00",
138                                "implication_of_limit_breach": "START_GRACE_PERIOD"
139                            }
140                        ],
141                        "grace_periods": [
142                            {
143                                "start_time": "2025-09-24T21:40:31.000Z",
144                                "expiry_time": "2025-10-24T21:40:31.000Z"
145                            }
146                        ]
147                    },
148                    {
149                        "name": "PAYPAL_WALLET_VAULTING_ADVANCED"
150                    },
151                    {
152                        "name": "CUSTOM_CARD_PROCESSING",
153                        "limits": [
154                            {
155                                "type": "AMOUNT",
156                                "unit": "CAD",
157                                "value": "3000.00",
158                                "remaining_value": "3000.00",
159                                "implication_of_limit_breach": "START_GRACE_PERIOD"
160                            }
161                        ],
162                        "grace_periods": [
163                            {
164                                "start_time": "2025-09-24T21:40:31.000Z",
165                                "expiry_time": "2025-10-24T21:40:31.000Z"
166                            }
167                        ]
168                    }
169                ]
170            },
171            {
172                "name": "MANAGED_PATH_KYC_COLLECTION",
173                "status": "COMPLETED",
174                "capabilities": [
175                    {
176                        "name": "APPLE_PAY"
177                    },
178                    {
179                        "name": "PAYPAL_WALLET_VAULTING_ADVANCED"
180                    },
181                    {
182                        "name": "CUSTOM_CARD_PROCESSING"
183                    }
184                ]
185            }
186        ]
187    },
188    "links": [
189        {
190            "href": "https://msmaster.qa.paypal.com:26876/v3/customer/managed-accounts/D4H2M7V6BGEB6",
191            "rel": "self",
192            "method": "GET"
193        },
194        {
195            "href": "https://msmaster.qa.paypal.com:26876/v3/customer/managed-accounts/D4H2M7V6BGEB6",
196            "rel": "edit",
197            "method": "PATCH"
198        }
199    ]
200}

Indonesia

The following sample requests and responses and show the account creation examples for different business types in Indonesia.

Sample requests

  1. Corporation
  2. Individual
  3. Nonprofit
  4. Proprietorship
  5. Private Corporation
  6. Public Company
  7. Government
  8. Association
  9. Other Corporate Body
  10. Partnership
  11. Proprietory Company
  12. Registered Cooperative
1{
2    "external_id": "EXT-499025",
3    "legal_country_code": "ID",
4    "organization": "indonesia",
5    "primary_currency_code": "USD",
6    "individual_owners": [
7        {
8            "names": [
9                {
10                    "type": "LEGAL",
11                    "given_name": "MaryAPPROVED",
12                    "surname": "Collins"
13                }
14            ]
15        }
16    ],
17    "business_entity": {
18        "type": "CORPORATION",
19        "names": [
20            {
21                "type": "LEGAL",
22                "business_name": "Demo Inc."
23            }
24        ]
25    },
26    "agreements": [
27        {
28            "type": "TERMS_ACCEPTED",
29            "accepted_time": "2019-06-02T01:23:45Z"
30        }
31    ]
32}

Sample responses

  1. Corporation
  2. Individual
  3. Nonprofit
  4. Private Corporation
  5. Proprietorship
  6. Public Company
  7. Government
  8. Association
  9. Other Corporate Body
  10. Partnership
  11. Proprietory Company
  12. Registered Cooperative
1{
2    "account_id": "7CYQ3EFKLR32W",
3    "legal_country_code": "ID",
4    "individual_owners": [
5        {
6            "id": "7CYQ3EFKLR32W",
7            "names": [
8                {
9                    "given_name": "MaryAPPROVED",
10                    "surname": "Collins",
11                    "id": "JATBHBNGG9YMC",
12                    "type": "LEGAL"
13                }
14            ]
15        }
16    ],
17    "business_entity": {
18        "type": "CORPORATION",
19        "incorporation_details": {},
20        "names": [
21            {
22                "business_name": "Demo Inc.",
23                "id": "SCLQR4N5HPKXW",
24                "type": "LEGAL"
25            }
26        ]
27    },
28    "agreements": [
29        {
30            "type": "TERMS_ACCEPTED",
31            "accepted_time": "2019-06-02T01:23:45Z"
32        }
33    ],
34    "external_id": "EXT-499025",
35    "organization": "indonesia",
36    "primary_currency_code": "USD",
37    "soft_descriptor": "DEMO INC",
38    "capabilities": [
39        {
40            "name": "RECEIVE_MONEY",
41            "status": "ACTIVE"
42        },
43        {
44            "name": "PAYPAL_CHECKOUT",
45            "status": "ACTIVE"
46        }
47    ],
48    "links": [
49        {
50            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/7CYQ3EFKLR32W",
51            "rel": "self",
52            "method": "GET"
53        },
54        {
55            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/7CYQ3EFKLR32W",
56            "rel": "edit",
57            "method": "PATCH"
58        }
59    ]
60}

Maximum payload example

    1{
    2    "external_id": "EXT-1649440654255",
    3    "legal_country_code": "ID",
    4    "organization": "indonesia",
    5    "user_id": "1649440654255",
    6    "primary_currency_code": "USD",
    7    "soft_descriptor": "DemoInc",
    8    "individual_owners": [
    9        {
    10            "names": [
    11                {
    12                    "type": "LEGAL",
    13                    "given_name": "MaryAPPROVED",
    14                    "surname": "Collins"
    15                }
    16            ],
    17            "citizenship": "ID",
    18            "gender": "FEMALE",
    19            "primary_residence": {
    20                "address_line_1": "Dki Jakarta",
    21                "admin_area_1": "Jawa",
    22                "admin_area_2": "Jakarta",
    23                "postal_code": "50519",
    24                "country_code": "ID"
    25            },
    26            "tax_address": {
    27                "address_line_1": "Jl Soekarno Hatta 234",
    28                    "admin_area_1": "Jawa",
    29                    "admin_area_2": "Bandung",
    30                "postal_code": "50519",
    31                "country_code": "ID"
    32            },
    33            "addresses": [
    34                {
    35                    "type": "HOME",
    36                    "address_line_1": "Jl Mangga Besar Raya 85",
    37                    "admin_area_1": "Dki Jakarta",
    38                    "admin_area_2": "Jakarta",
    39                    "postal_code": "50519",
    40                    "country_code": "ID"
    41                }
    42            ],
    43            "phone_numbers": [
    44                {
    45                    "country_code": "62",
    46                    "national_number": "3939249447",
    47                    "type": "MOBILE"
    48                }
    49            ],
    50            "birth_details": {
    51                "date_of_birth": "1960-01-01"
    52            },
    53            "identification_documents": [
    54                {
    55                    "identification_number": "123456789",
    56                    "issue_date": "2020-01-01",
    57                    "expiry_date": "2025-01-01",
    58                    "issuing_country_code": "ID",
    59                    "type": "PASSPORT"
    60                }
    61            ],
    62            "emails": [
    63                {
    64                    "email": "[email protected]"
    65                }
    66            ],
    67            "agreements": [
    68                {
    69                    "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
    70                    "accepted_time": "2019-06-02T01:23:45Z",
    71                    "signature": "Mary Collins"
    72                }
    73            ]
    74        }
    75    ],
    76    "business_entity": {
    77        "type": "INDIVIDUAL",
    78        "merchant_category_code": "4121",
    79        "names": [
    80            {
    81                "type": "LEGAL",
    82                "business_name": "Demo Inc."
    83            },
    84            {
    85                "type": "DOING_BUSINESS_AS",
    86                "business_name": "Demo DBA Inc."
    87            }
    88        ],
    89        "emails": [
    90            {
    91                "email": "[email protected]"
    92            }
    93        ],
    94        "website": "paypal.com",
    95        "registered_business_address": {
    96            "type": "BUSINESS",
    97            "address_line_1": "Jl Mangga Besar Raya 85",
    98            "admin_area_1": "Jawa",
    99            "admin_area_2": "Jakarta",
    100            "postal_code": "50519",
    101            "country_code": "ID"
    102        },
    103        "principal_office_address": {
    104            "address_line_1": "Jl Soekarno Hatta 234",
    105            "admin_area_1": "Dki Jakarta",
    106            "admin_area_2": "Jakarta",
    107            "postal_code": "50519",
    108            "country_code": "ID"
    109        },
    110        "tax_address": {
    111            "address_line_1": "Jl Soekarno Hatta 234",
    112            "admin_area_1": "Jawa",
    113            "admin_area_2": "Bandung",
    114            "postal_code": "50519",
    115            "country_code": "ID"
    116        },
    117        "addresses": [
    118            {
    119                "address_line_1": "Jl Mangga Besar Raya 85",
    120                "admin_area_1": "Dki Jakarta",
    121                "admin_area_2": "Jakarta",
    122                "postal_code": "50519",
    123                "country_code": "ID",
    124                "type": "MAILING"
    125            }
    126        ],
    127        "identification_documents": [
    128            {
    129                "identification_number": "8000012050001",
    130                "issue_date": "2020-01-01",
    131                "issuing_country_code": "ID",
    132                "type": "BUSINESS_REGISTRATION_NUMBER"
    133            }
    134        ],
    135        "incorporation_details": {
    136            "incorporation_country_code": "ID",
    137            "incorporation_date": "2019-01-01",
    138            "incorporation_province_code": "O1"
    139        },
    140        "phone_numbers": [
    141            {
    142                "country_code": "62",
    143                "national_number": "3939249447",
    144                "type": "BUSINESS"
    145            }
    146        ],
    147        "beneficial_owners": {
    148            "individuals": [
    149                {
    150                    "percentage_of_ownership": "25",
    151                    "names": [
    152                        {
    153                            "type": "LEGAL",
    154                            "given_name": "MaryAPPROVED",
    155                            "surname": "Collins"
    156                        }
    157                    ],
    158                    "citizenship": "ID",
    159                    "gender": "FEMALE",
    160                    "primary_residence": {
    161                        "address_line_1": "Jl Mangga Besar Raya 85",
    162                        "admin_area_1": "Dki Jakarta",
    163                        "admin_area_2": "Jakarta",
    164                        "postal_code": "50519",
    165                        "country_code": "ID"
    166                    },
    167                    "tax_address": {
    168                        "address_line_1": "Jl Soekarno Hatta 234",
    169                        "admin_area_1": "Jawa",
    170                        "admin_area_2": "Bandung",
    171                        "postal_code": "50519",
    172                        "country_code": "ID"
    173                    },
    174                    "addresses": [
    175                        {
    176                            "type": "HOME",
    177                            "address_line_1": "Dki Jakarta",
    178                            "admin_area_1": "Dki Jakarta",
    179                            "admin_area_2": "Jakarta",
    180                            "postal_code": "50519",
    181                            "country_code": "ID"
    182                        }
    183                    ],
    184                    "birth_details": {
    185                        "date_of_birth": "1960-01-01"
    186                    },
    187                    "identification_documents": [
    188                        {
    189                            "identification_number": "123456789",
    190                            "issue_date": "2020-01-01",
    191                            "expiry_date": "2025-01-01",
    192                            "issuing_country_code": "ID",
    193                            "type": "PASSPORT"
    194                        }
    195                    ],
    196                    "emails": [
    197                        {
    198                            "email": "[email protected]"
    199                        }
    200                    ],
    201                    "agreements": [
    202                        {
    203                            "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
    204                            "accepted_time": "2019-06-02T01:23:45Z",
    205                            "signature": "Mary Collins"
    206                        }
    207                    ],
    208                    "declarations": [
    209                        {
    210                            "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
    211                            "value": "YES"
    212                        }
    213                    ]
    214                }
    215            ],
    216            "office_bearers": [
    217                {
    218                    "role": "CEO",
    219                    "names": [
    220                        {
    221                            "type": "LEGAL",
    222                            "given_name": "MaryAPPROVED",
    223                            "surname": "Collins"
    224                        }
    225                    ],
    226                    "citizenship": "ID",
    227                    "gender": "FEMALE",
    228                    "primary_residence": {
    229                        "address_line_1": "Dki Jakarta",
    230                        "admin_area_1": "Dki Jakarta",
    231                        "admin_area_2": "Jakarta",
    232                        "postal_code": "50519",
    233                        "country_code": "ID"
    234                    },
    235                    "tax_address": {
    236                        "address_line_1": "Jawa",
    237                        "admin_area_1": "Jawa",
    238                        "admin_area_2": "Bandung",
    239                        "postal_code": "50519",
    240                        "country_code": "ID"
    241                    },
    242                    "addresses": [
    243                        {
    244                            "type": "HOME",
    245                            "address_line_1": "Dki Jakarta",
    246                            "admin_area_1": "Dki Jakarta",
    247                            "admin_area_2": "Jakarta",
    248                            "postal_code": "50519",
    249                            "country_code": "ID"
    250                        }
    251                    ],
    252                    "birth_details": {
    253                        "date_of_birth": "1960-01-01"
    254                    },
    255                    "identification_documents": [
    256                        {
    257                            "identification_number": "123456789",
    258                            "issue_date": "2020-01-01",
    259                            "expiry_date": "2025-01-01",
    260                            "issuing_country_code": "ID",
    261                            "type": "PASSPORT"
    262                        }
    263                    ],
    264                    "emails": [
    265                        {
    266                            "email": "[email protected]"
    267                        }
    268                    ],
    269                    "agreements": [
    270                        {
    271                            "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
    272                            "accepted_time": "2019-06-02T01:23:45Z",
    273                            "signature": "Mary Collins"
    274                        }
    275                    ]
    276                }
    277            ]
    278        }
    279    },
    280    "agreements": [
    281        {
    282            "type": "TERMS_ACCEPTED",
    283            "accepted_time": "2019-06-02T01:23:45Z"
    284        }
    285    ]
    286}

    Japan

    The following sample requests and responses show the account creation examples for different business types in Japan.

    Sample requests

    1. Corporation
    2. Individual
    3. Nonprofit
    4. Private Corporation
    5. Proprietorship
    6. Public Company
    7. Government
    8. Association
    1{
    2    "external_id": "EXT-463430",
    3    "legal_country_code": "JP",
    4    "organization": "japan",
    5    "primary_currency_code": "JPY",
    6    "individual_owners": [
    7        {
    8            "names": [
    9                {
    10                    "type": "LEGAL",
    11                    "given_name": "MaryAPPROVED",
    12                    "surname": "Collins"
    13                }
    14            ]
    15        }
    16    ],
    17    "business_entity": {
    18        "type": "CORPORATION",
    19        "names": [
    20            {
    21                "type": "LEGAL",
    22                "business_name": "Demo Inc."
    23            }
    24        ]
    25    },
    26    "agreements": [
    27        {
    28            "type": "TERMS_ACCEPTED",
    29            "accepted_time": "2019-06-02T01:23:45Z"
    30        }
    31    ]
    32}

    Sample responses

    1. Corporation
    2. Individual
    3. Nonprofit
    4. Private Corporation
    5. Proprietorship
    6. Public Company
    7. Government
    1{
    2    "account_id": "GTEXV87ANEC3S",
    3    "legal_country_code": "JP",
    4    "individual_owners": [
    5        {
    6            "id": "GTEXV87ANEC3S",
    7            "names": [
    8                {
    9                    "given_name": "MaryAPPROVED",
    10                    "surname": "Collins",
    11                    "id": "Y3VG8Z9BDNXA6",
    12                    "type": "LEGAL"
    13                }
    14            ]
    15        }
    16    ],
    17    "business_entity": {
    18        "type": "CORPORATION",
    19        "incorporation_details": {},
    20        "names": [
    21            {
    22                "business_name": "Demo Inc.",
    23                "id": "BWK5VZPVZPMT4",
    24                "type": "LEGAL"
    25            }
    26        ]
    27    },
    28    "agreements": [
    29        {
    30            "type": "TERMS_ACCEPTED",
    31            "accepted_time": "2019-06-02T01:23:45Z"
    32        }
    33    ],
    34    "external_id": "EXT-463430",
    35    "organization": "japan",
    36    "primary_currency_code": "JPY",
    37    "soft_descriptor": "DEMO INC",
    38    "capabilities": [
    39        {
    40            "name": "RECEIVE_MONEY",
    41            "status": "ACTIVE"
    42        },
    43        {
    44            "name": "PAYPAL_CHECKOUT",
    45            "status": "ACTIVE"
    46        }
    47    ],
    48    "links": [
    49        {
    50            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/GTEXV87ANEC3S",
    51            "rel": "self",
    52            "method": "GET"
    53        },
    54        {
    55            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/GTEXV87ANEC3S",
    56            "rel": "edit",
    57            "method": "PATCH"
    58        }
    59    ]
    60}

    Maximum payload example

      1{
      2  "external_id": "EXT-{{currentTime}}",
      3  "legal_country_code": "JP",
      4  "organization": "japan",
      5  "user_id": "{{currentTime}}",
      6  "primary_currency_code": "JPY",
      7  "soft_descriptor": "DemoInc",
      8  "individual_owners": [
      9    {
      10      "names": [
      11        {
      12          "type": "LEGAL",
      13          "given_name": "MaryAPPROVED",
      14          "surname": "Collins"
      15        }
      16      ],
      17      "citizenship": "JP",
      18      "gender": "FEMALE",
      19      "primary_residence": {
      20        "address_line_1": "2-543 Aza Hagidaira, Kawaji",
      21        "admin_area_2": "Miyazaki-Shi",
      22        "admin_area_1": "OT",
      23        "postal_code": "880-0911",
      24        "country_code": "JP"
      25      },
      26      "tax_address": {
      27        "address_line_1": "Nishi 0-Chome, Kita 13-Jo, Kita-Ku",
      28        "admin_area_1": "O4",
      29        "admin_area_2": "Uwajima-Shi",
      30        "postal_code": "798-0022",
      31        "country_code": "JP"
      32      },
      33      "addresses": [
      34        {
      35          "type": "HOME",
      36          "address_line_1": "5774 Tominokojidori Ayanokojisagaru, Nushiya-Cho, Shimogyo-Ku",
      37          "admin_area_1": "26",
      38          "admin_area_2": "Kawanehon-Cho",
      39          "postal_code": "428-0417",
      40          "country_code": "JP"
      41        }
      42      ],
      43      "phone_numbers": [
      44        {
      45          "country_code": "81",
      46          "national_number": "3939249447",
      47          "type": "MOBILE"
      48        }
      49      ],
      50      "birth_details": {
      51        "date_of_birth": "1960-01-01"
      52      },
      53      "identification_documents": [
      54        {
      55          "identification_number": "123456789",
      56          "issue_date": "2020-01-01",
      57          "expiry_date": "2025-01-01",
      58          "issuing_country_code": "JP",
      59          "type": "PASSPORT"
      60        }
      61      ],
      62      "emails": [
      63        {
      64          "email": "[email protected]"
      65        }
      66      ],
      67      "agreements": [
      68        {
      69          "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
      70          "accepted_time": "2019-06-02T01:23:45Z",
      71          "signature": "Mary Collins"
      72        }
      73      ]
      74    }
      75  ],
      76  "business_entity": {
      77    "type": "INDIVIDUAL",
      78    "merchant_category_code": "4121",
      79    "names": [
      80      {
      81        "type": "LEGAL",
      82        "business_name": "Demo Inc."
      83      },
      84      {
      85        "type": "DOING_BUSINESS_AS",
      86        "business_name": "Demo DBA Inc."
      87      }
      88    ],
      89    "emails": [
      90      {
      91        "email": "[email protected]"
      92      }
      93    ],
      94    "website": "paypal.com",
      95    "registered_business_address": {
      96      "type": "BUSINESS",
      97      "address_line_1": "9278-6 Oaza Tayoshi",
      98      "admin_area_1": "O4",
      99      "admin_area_2": "Uwajima-Shi",
      100      "postal_code": "798-0022",
      101      "country_code": "JP"
      102    },
      103    "principal_office_address": {
      104      "address_line_1": "800055-9096 Kisshoin-Ishihara-Nagata",
      105      "admin_area_1": "OT",
      106      "admin_area_2": "Miyazaki-Shi",
      107      "postal_code": "880-0911",
      108      "country_code": "JP"
      109    },
      110    "tax_address": {
      111      "address_line_1": "2-9-1 Yata, Higashisumiyoshi-Ku",
      112      "admin_area_1": "OP",
      113      "admin_area_2": "Kyoto-Shi",
      114      "postal_code": "600-8053",
      115      "country_code": "JP"
      116    },
      117    "addresses": [
      118      {
      119        "address_line_1": "2679-761-163Matsushima",
      120        "admin_area_1": "O2",
      121        "admin_area_2": "Hirosaki-Shi",
      122        "postal_code": "036-8503",
      123        "country_code": "JP",
      124        "type": "MAILING"
      125      }
      126    ],
      127    "identification_documents": [
      128      {
      129        "identification_number": "8000012050001",
      130        "issue_date": "2020-01-01",
      131        "issuing_country_code": "JP",
      132        "type": "BUSINESS_REGISTRATION_NUMBER"
      133      }
      134    ],
      135    "incorporation_details": {
      136      "incorporation_country_code": "JP",
      137      "incorporation_date": "2019-01-01",
      138      "incorporation_province_code": "O1"
      139    },
      140    "phone_numbers": [
      141      {
      142        "country_code": "81",
      143        "national_number": "3939249447",
      144        "type": "BUSINESS"
      145      }
      146    ],
      147    "beneficial_owners": {
      148      "individuals": [
      149        {
      150          "percentage_of_ownership": "25",
      151          "names": [
      152            {
      153              "type": "LEGAL",
      154              "given_name": "MaryAPPROVED",
      155              "surname": "Collins"
      156            }
      157          ],
      158          "citizenship": "JP",
      159          "gender": "FEMALE",
      160          "primary_residence": {
      161            "address_line_1": "Kusayama Bldg. 2F, 507-66-577",
      162            "admin_area_1": "OB",
      163            "admin_area_2": "Sapporo-Shi",
      164            "postal_code": "060-0812",
      165            "country_code": "JP"
      166          },
      167          "tax_address": {
      168            "address_line_1": "Kusayama Bldg. 8F, 107-57-869",
      169            "admin_area_1": "21",
      170            "admin_area_2": "Osaka-Shi",
      171            "postal_code": "546-0023",
      172            "country_code": "JP"
      173          },
      174          "addresses": [
      175            {
      176              "type": "HOME",
      177              "address_line_1": "4979 Tominokojidori Ayanokojisagaru, Nushiya-Cho, Shimogyo-Ku",
      178              "admin_area_1": "27",
      179              "admin_area_2": "Utsunomiya-Shi",
      180              "postal_code": "321-0346",
      181              "country_code": "JP"
      182            }
      183          ],
      184          "birth_details": {
      185            "date_of_birth": "1960-01-01"
      186          },
      187          "identification_documents": [
      188            {
      189              "identification_number": "123456789",
      190              "issue_date": "2020-01-01",
      191              "expiry_date": "2025-01-01",
      192              "issuing_country_code": "JP",
      193              "type": "PASSPORT"
      194            }
      195          ],
      196          "emails": [
      197            {
      198              "email": "[email protected]"
      199            }
      200          ],
      201          "agreements": [
      202            {
      203              "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
      204              "accepted_time": "2019-06-02T01:23:45Z",
      205              "signature": "Mary Collins"
      206            }
      207          ],
      208          "declarations": [
      209            {
      210              "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
      211              "value": "YES"
      212            }
      213          ]
      214        }
      215      ],
      216      "office_bearers": [
      217        {
      218          "role": "CEO",
      219          "names": [
      220            {
      221              "type": "LEGAL",
      222              "given_name": "MaryAPPROVED",
      223              "surname": "Collins"
      224            }
      225          ],
      226          "citizenship": "JP",
      227          "gender": "FEMALE",
      228          "primary_residence": {
      229            "address_line_1": "3610 Nagasaka, Shimoarahari-Machi",
      230            "admin_area_1": "21",
      231            "admin_area_2": "Osaka-Shi",
      232            "postal_code": "546-0023",
      233            "country_code": "JP"
      234          },
      235          "tax_address": {
      236            "address_line_1": "4760 Tominokojidori Ayanokojisagaru, Nushiya-Cho, Shimogyo-Ku",
      237            "admin_area_1": "O3",
      238            "admin_area_2": "Ichikawa-Shi",
      239            "postal_code": "272-0138",
      240            "country_code": "JP"
      241          },
      242          "addresses": [
      243            {
      244              "type": "HOME",
      245              "address_line_1": "6592 Baba, Ibuki-Cho",
      246              "admin_area_1": "27",
      247              "admin_area_2": "Utsunomiya-Shi",
      248              "postal_code": "321-0346",
      249              "country_code": "JP"
      250            }
      251          ],
      252          "birth_details": {
      253            "date_of_birth": "1960-01-01"
      254          },
      255          "identification_documents": [
      256            {
      257              "identification_number": "123456789",
      258              "issue_date": "2020-01-01",
      259              "expiry_date": "2025-01-01",
      260              "issuing_country_code": "JP",
      261              "type": "PASSPORT"
      262            }
      263          ],
      264          "emails": [
      265            {
      266              "email": "[email protected]"
      267            }
      268          ],
      269          "agreements": [
      270            {
      271              "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
      272              "accepted_time": "2019-06-02T01:23:45Z",
      273              "signature": "Mary Collins"
      274            }
      275          ]
      276        }
      277      ]
      278    }
      279  },
      280  "agreements": [
      281    {
      282      "type": "TERMS_ACCEPTED",
      283      "accepted_time": "2019-06-02T01:23:45Z"
      284    }
      285  ]
      286}

      South Africa

      The following sample requests and responses show the account creation examples for different business types in South Africa.

      Sample requests

      1. Corporation
      2. Individual
      3. Nonprofit
      4. Private Corporation
      5. Proprietorship
      6. Public Company
      7. Government
      8. Association
      9. Other Corporate Body
      10. Partnership
      11. Proprietory Company
      12. Registered Cooperative
      1{
      2    {
      3    "external_id": "EXT-1649382589211",
      4    "legal_country_code": "ZA",
      5    "organization": "south_africa",
      6    "primary_currency_code": "USD",
      7    "individual_owners": [
      8        {
      9            "names": [
      10                {
      11                    "type": "LEGAL",
      12                    "given_name": "MaryAPPROVED",
      13                    "surname": "Collins"
      14                }
      15            ]
      16        }
      17    ],
      18    "business_entity": {
      19        "type": "CORPORATION",
      20        "names": [
      21            {
      22                "type": "LEGAL",
      23                "business_name": "Demo Inc."
      24            }
      25        ]
      26    },
      27    "agreements": [
      28        {
      29            "type": "TERMS_ACCEPTED",
      30            "accepted_time": "2019-06-02T01:23:45Z"
      31        }
      32    ]
      33}

      Sample responses

      1. Corporation
      2. Individual
      3. Nonprofit
      4. Private Corporation
      5. Proprietorship
      6. Public Company
      7. Government
      8. Association
      9. Other Corporate Body
      10. Partnership
      11. Proprietory Company
      12. Registered Cooperative
      1{
      2    "account_id": "WXHJ2JFC6BEVA",
      3    "legal_country_code": "ZA",
      4    "individual_owners": [
      5        {
      6            "id": "WXHJ2JFC6BEVA",
      7            "names": [
      8                {
      9                    "given_name": "MaryAPPROVED",
      10                    "surname": "Collins",
      11                    "id": "EDBXMF49KHQ58",
      12                    "type": "LEGAL"
      13                }
      14            ]
      15        }
      16    ],
      17    "business_entity": {
      18        "type": "CORPORATION",
      19        "incorporation_details": {},
      20        "names": [
      21            {
      22                "business_name": "Demo Inc.",
      23                "id": "JVP953GR7QLNY",
      24                "type": "LEGAL"
      25            }
      26        ]
      27    },
      28    "agreements": [
      29        {
      30            "type": "TERMS_ACCEPTED",
      31            "accepted_time": "2019-06-02T01:23:45Z"
      32        }
      33    ],
      34    "external_id": "EXT-1649382589211",
      35    "organization": "south_africa",
      36    "primary_currency_code": "USD",
      37    "soft_descriptor": "DEMO INC",
      38    "capabilities": [
      39        {
      40            "name": "RECEIVE_MONEY",
      41            "status": "ACTIVE"
      42        },
      43        {
      44            "name": "PAYPAL_CHECKOUT",
      45            "status": "ACTIVE"
      46        }
      47    ],
      48    "links": [
      49        {
      50            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/WXHJ2JFC6BEVA",
      51            "rel": "self",
      52            "method": "GET"
      53        },
      54        {
      55            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/WXHJ2JFC6BEVA",
      56            "rel": "edit",
      57            "method": "PATCH"
      58        }
      59    ]
      60}

      Maximum payload example

      1. Sample full request
      2. Sample full response
      1{
      2    "external_id": "EXT-1649441958176",
      3    "legal_country_code": "ZA",
      4    "organization": "south_africa",
      5    "user_id": "1649441958176",
      6    "primary_currency_code": "USD",
      7    "soft_descriptor": "DemoInc",
      8    "individual_owners": [
      9        {
      10            "names": [
      11                {
      12                    "type": "LEGAL",
      13                    "given_name": "MaryAPPROVED",
      14                    "surname": "Collins"
      15                }
      16            ],
      17            "citizenship": "ZA",
      18            "gender": "FEMALE",
      19            "primary_residence": {
      20                "address_line_1": "Mkhuhlu",
      21                "admin_area_1": "Silverton",
      22                "admin_area_2": "Mpumalanga",
      23                "postal_code": "8301",
      24                "country_code": "ZA"
      25            },
      26            "tax_address": {
      27                "address_line_1": "1681 Glyn St",
      28                    "admin_area_1": "Silverton",
      29                    "admin_area_2": "Gauteng",
      30                "postal_code": "8301",
      31                "country_code": "ZA"
      32            },
      33            "addresses": [
      34                {
      35                    "type": "HOME",
      36                    "address_line_1": "706 Ireland St",
      37                    "admin_area_1": "Mkhuhlu",
      38                    "admin_area_2": "Mpumalanga",
      39                    "postal_code": "8301",
      40                    "country_code": "ZA"
      41                }
      42            ],
      43            "phone_numbers": [
      44                {
      45                    "country_code": "27",
      46                    "national_number": "3939249447",
      47                    "type": "MOBILE"
      48                }
      49            ],
      50            "birth_details": {
      51                "date_of_birth": "1960-01-01"
      52            },
      53            "identification_documents": [
      54                {
      55                    "identification_number": "123456789",
      56                    "issue_date": "2020-01-01",
      57                    "expiry_date": "2025-01-01",
      58                    "issuing_country_code": "ZA",
      59                    "type": "PASSPORT"
      60                }
      61            ],
      62            "emails": [
      63                {
      64                    "email": "[email protected]"
      65                }
      66            ],
      67            "agreements": [
      68                {
      69                    "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
      70                    "accepted_time": "2019-06-02T01:23:45Z",
      71                    "signature": "Mary Collins"
      72                }
      73            ]
      74        }
      75    ],
      76    "business_entity": {
      77        "type": "INDIVIDUAL",
      78        "merchant_category_code": "4121",
      79        "names": [
      80            {
      81                "type": "LEGAL",
      82                "business_name": "Demo Inc."
      83            },
      84            {
      85                "type": "DOING_BUSINESS_AS",
      86                "business_name": "Demo DBA Inc."
      87            }
      88        ],
      89        "emails": [
      90            {
      91                "email": "[email protected]"
      92            }
      93        ],
      94        "website": "paypal.com",
      95        "registered_business_address": {
      96            "type": "BUSINESS",
      97            "address_line_1": "706 Ireland St",
      98            "admin_area_1": "Silverton",
      99            "admin_area_2": "Mpumalanga",
      100            "postal_code": "8301",
      101            "country_code": "ZA"
      102        },
      103        "principal_office_address": {
      104            "address_line_1": "1681 Glyn St",
      105            "admin_area_1": "Mkhuhlu",
      106            "admin_area_2": "Mpumalanga",
      107            "postal_code": "8301",
      108            "country_code": "ZA"
      109        },
      110        "tax_address": {
      111            "address_line_1": "1681 Glyn St",
      112            "admin_area_1": "Silverton",
      113            "admin_area_2": "Gauteng",
      114            "postal_code": "8301",
      115            "country_code": "ZA"
      116        },
      117        "addresses": [
      118            {
      119                "address_line_1": "706 Ireland St",
      120                "admin_area_1": "Mkhuhlu",
      121                "admin_area_2": "Mpumalanga",
      122                "postal_code": "8301",
      123                "country_code": "ZA",
      124                "type": "MAILING"
      125            }
      126        ],
      127        "identification_documents": [
      128            {
      129                "identification_number": "8000012050001",
      130                "issue_date": "2020-01-01",
      131                "issuing_country_code": "ZA",
      132                "type": "BUSINESS_REGISTRATION_NUMBER"
      133            }
      134        ],
      135        "incorporation_details": {
      136            "incorporation_country_code": "ZA",
      137            "incorporation_date": "2019-01-01",
      138            "incorporation_province_code": "O1"
      139        },
      140        "phone_numbers": [
      141            {
      142                "country_code": "27",
      143                "national_number": "3939249447",
      144                "type": "BUSINESS"
      145            }
      146        ],
      147        "beneficial_owners": {
      148            "individuals": [
      149                {
      150                    "percentage_of_ownership": "25",
      151                    "names": [
      152                        {
      153                            "type": "LEGAL",
      154                            "given_name": "MaryAPPROVED",
      155                            "surname": "Collins"
      156                        }
      157                    ],
      158                    "citizenship": "ZA",
      159                    "gender": "FEMALE",
      160                    "primary_residence": {
      161                        "address_line_1": "706 Ireland St",
      162                        "admin_area_1": "Mkhuhlu",
      163                        "admin_area_2": "Mpumalanga",
      164                        "postal_code": "8301",
      165                        "country_code": "ZA"
      166                    },
      167                    "tax_address": {
      168                        "address_line_1": "1681 Glyn St",
      169                        "admin_area_1": "Silverton",
      170                        "admin_area_2": "Gauteng",
      171                        "postal_code": "8301",
      172                        "country_code": "ZA"
      173                    },
      174                    "addresses": [
      175                        {
      176                            "type": "HOME",
      177                            "address_line_1": "Mkhuhlu",
      178                            "admin_area_1": "Mkhuhlu",
      179                            "admin_area_2": "Mpumalanga",
      180                            "postal_code": "8301",
      181                            "country_code": "ZA"
      182                        }
      183                    ],
      184                    "birth_details": {
      185                        "date_of_birth": "1960-01-01"
      186                    },
      187                    "identification_documents": [
      188                        {
      189                            "identification_number": "123456789",
      190                            "issue_date": "2020-01-01",
      191                            "expiry_date": "2025-01-01",
      192                            "issuing_country_code": "ZA",
      193                            "type": "PASSPORT"
      194                        }
      195                    ],
      196                    "emails": [
      197                        {
      198                            "email": "[email protected]"
      199                        }
      200                    ],
      201                    "agreements": [
      202                        {
      203                            "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
      204                            "accepted_time": "2019-06-02T01:23:45Z",
      205                            "signature": "Mary Collins"
      206                        }
      207                    ],
      208                    "declarations": [
      209                        {
      210                            "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
      211                            "value": "YES"
      212                        }
      213                    ]
      214                }
      215            ],
      216            "office_bearers": [
      217                {
      218                    "role": "CEO",
      219                    "names": [
      220                        {
      221                            "type": "LEGAL",
      222                            "given_name": "MaryAPPROVED",
      223                            "surname": "Collins"
      224                        }
      225                    ],
      226                    "citizenship": "ZA",
      227                    "gender": "FEMALE",
      228                    "primary_residence": {
      229                        "address_line_1": "Mkhuhlu",
      230                        "admin_area_1": "Mkhuhlu",
      231                        "admin_area_2": "Mpumalanga",
      232                        "postal_code": "8301",
      233                        "country_code": "ZA"
      234                    },
      235                    "tax_address": {
      236                        "address_line_1": "Silverton",
      237                        "admin_area_1": "Silverton",
      238                        "admin_area_2": "Gauteng",
      239                        "postal_code": "8301",
      240                        "country_code": "ZA"
      241                    },
      242                    "addresses": [
      243                        {
      244                            "type": "HOME",
      245                            "address_line_1": "Mkhuhlu",
      246                            "admin_area_1": "Mkhuhlu",
      247                            "admin_area_2": "Mpumalanga",
      248                            "postal_code": "8301",
      249                            "country_code": "ZA"
      250                        }
      251                    ],
      252                    "birth_details": {
      253                        "date_of_birth": "1960-01-01"
      254                    },
      255                    "identification_documents": [
      256                        {
      257                            "identification_number": "123456789",
      258                            "issue_date": "2020-01-01",
      259                            "expiry_date": "2025-01-01",
      260                            "issuing_country_code": "ZA",
      261                            "type": "PASSPORT"
      262                        }
      263                    ],
      264                    "emails": [
      265                        {
      266                            "email": "[email protected]"
      267                        }
      268                    ],
      269                    "agreements": [
      270                        {
      271                            "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
      272                            "accepted_time": "2019-06-02T01:23:45Z",
      273                            "signature": "Mary Collins"
      274                        }
      275                    ]
      276                }
      277            ]
      278        }
      279    },
      280    "agreements": [
      281        {
      282            "type": "TERMS_ACCEPTED",
      283            "accepted_time": "2019-06-02T01:23:45Z"
      284        }
      285    ]
      286}

      United Arab Emirates

      The following sample requests and responses show the account creation examples for different business types in UAE.

      Sample requests

      1. Corporation
      2. Individual
      3. Nonprofit
      4. Private Corporation
      5. Proprietorship
      6. Public Company
      7. Government
      8. Association
      9. Partnership
      10. Proprietory Company
      11. Registered Cooperative
      1{
      2    "external_id": "EXT-1649379593429",
      3    "legal_country_code": "AE",
      4    "organization": "uae-ppcb",
      5    "primary_currency_code": "USD",
      6    "individual_owners": [
      7        {
      8            "names": [
      9                {
      10                    "type": "LEGAL",
      11                    "given_name": "MaryAPPROVED",
      12                    "surname": "Collins"
      13                }
      14            ]
      15        }
      16    ],
      17    "business_entity": {
      18        "type": "CORPORATION",
      19        "names": [
      20            {
      21                "type": "LEGAL",
      22                "business_name": "Demo Inc."
      23            }
      24        ]
      25    },
      26    "agreements": [
      27        {
      28            "type": "TERMS_ACCEPTED",
      29            "accepted_time": "2019-06-02T01:23:45Z"
      30        }
      31    ]
      32}

      Sample responses

      1. Corporation
      2. Individual
      3. Nonprofit
      4. Private Corporation
      5. Proprietorship
      6. Public Company
      7. Government
      8. Association
      9. Other Corporate Body
      10. Partnership
      11. Proprietory Company
      12. Registered Cooperative
      1{
      2    "account_id": "Q9PMZ5T33X9U6",
      3    "legal_country_code": "AE",
      4    "individual_owners": [
      5        {
      6            "id": "Q9PMZ5T33X9U6",
      7            "names": [
      8                {
      9                    "given_name": "MaryAPPROVED",
      10                    "surname": "Collins",
      11                    "id": "2KVMCZCSWKVFS",
      12                    "type": "LEGAL"
      13                }
      14            ]
      15        }
      16    ],
      17    "business_entity": {
      18        "type": "CORPORATION",
      19        "incorporation_details": {},
      20        "names": [
      21            {
      22                "business_name": "Demo Inc.",
      23                "id": "KVGGJ5LTPXAKS",
      24                "type": "LEGAL"
      25            }
      26        ]
      27    },
      28    "agreements": [
      29        {
      30            "type": "TERMS_ACCEPTED",
      31            "accepted_time": "2019-06-02T01:23:45Z"
      32        }
      33    ],
      34    "external_id": "EXT-1649379593429",
      35    "organization": "uae-ppcb",
      36    "primary_currency_code": "USD",
      37    "soft_descriptor": "DEMO INC",
      38    "capabilities": [
      39        {
      40            "name": "RECEIVE_MONEY",
      41            "status": "ACTIVE"
      42        },
      43        {
      44            "name": "PAYPAL_CHECKOUT",
      45            "status": "ACTIVE"
      46        }
      47    ],
      48    "links": [
      49        {
      50            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/Q9PMZ5T33X9U6",
      51            "rel": "self",
      52            "method": "GET"
      53        },
      54        {
      55            "href": "https://sandbox.qa.paypal.com/v3/customer/managed-accounts/Q9PMZ5T33X9U6",
      56            "rel": "edit",
      57            "method": "PATCH"
      58        }
      59    ]
      60}

      Maximum payload example

        1{
        2    "external_id": "EXT-1649441958176",
        3    "legal_country_code": "AE",
        4    "organization": "uae-ppcb",
        5    "user_id": "1649441958176",
        6    "primary_currency_code": "USD",
        7    "soft_descriptor": "DemoInc",
        8    "individual_owners": [
        9        {
        10            "names": [
        11                {
        12                    "type": "LEGAL",
        13                    "given_name": "MaryAPPROVED",
        14                    "surname": "Collins"
        15                }
        16            ],
        17            "citizenship": "ZA",
        18            "gender": "FEMALE",
        19            "primary_residence": {
        20                "address_line_1": "Mkhuhlu",
        21                "admin_area_1": "Silverton",
        22                "admin_area_2": "Mpumalanga",
        23                "postal_code": "8301",
        24                "country_code": "ZA"
        25            },
        26            "tax_address": {
        27                "address_line_1": "1681 Glyn St",
        28                    "admin_area_1": "Silverton",
        29                    "admin_area_2": "Gauteng",
        30                "postal_code": "8301",
        31                "country_code": "ZA"
        32            },
        33            "addresses": [
        34                {
        35                    "type": "HOME",
        36                    "address_line_1": "706 Ireland St",
        37                    "admin_area_1": "Mkhuhlu",
        38                    "admin_area_2": "Mpumalanga",
        39                    "postal_code": "8301",
        40                    "country_code": "ZA"
        41                }
        42            ],
        43            "phone_numbers": [
        44                {
        45                    "country_code": "27",
        46                    "national_number": "3939249447",
        47                    "type": "MOBILE"
        48                }
        49            ],
        50            "birth_details": {
        51                "date_of_birth": "1960-01-01"
        52            },
        53            "identification_documents": [
        54                {
        55                    "identification_number": "123456789",
        56                    "issue_date": "2020-01-01",
        57                    "expiry_date": "2025-01-01",
        58                    "issuing_country_code": "ZA",
        59                    "type": "PASSPORT"
        60                }
        61            ],
        62            "emails": [
        63                {
        64                    "email": "[email protected]"
        65                }
        66            ],
        67            "agreements": [
        68                {
        69                    "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
        70                    "accepted_time": "2019-06-02T01:23:45Z",
        71                    "signature": "Mary Collins"
        72                }
        73            ]
        74        }
        75    ],
        76    "business_entity": {
        77        "type": "INDIVIDUAL",
        78        "merchant_category_code": "4121",
        79        "names": [
        80            {
        81                "type": "LEGAL",
        82                "business_name": "Demo Inc."
        83            },
        84            {
        85                "type": "DOING_BUSINESS_AS",
        86                "business_name": "Demo DBA Inc."
        87            }
        88        ],
        89        "emails": [
        90            {
        91                "email": "[email protected]"
        92            }
        93        ],
        94        "website": "paypal.com",
        95        "registered_business_address": {
        96            "type": "BUSINESS",
        97            "address_line_1": "706 Ireland St",
        98            "admin_area_1": "Silverton",
        99            "admin_area_2": "Mpumalanga",
        100            "postal_code": "8301",
        101            "country_code": "ZA"
        102        },
        103        "principal_office_address": {
        104            "address_line_1": "1681 Glyn St",
        105            "admin_area_1": "Mkhuhlu",
        106            "admin_area_2": "Mpumalanga",
        107            "postal_code": "8301",
        108            "country_code": "ZA"
        109        },
        110        "tax_address": {
        111            "address_line_1": "1681 Glyn St",
        112            "admin_area_1": "Silverton",
        113            "admin_area_2": "Gauteng",
        114            "postal_code": "8301",
        115            "country_code": "ZA"
        116        },
        117        "addresses": [
        118            {
        119                "address_line_1": "706 Ireland St",
        120                "admin_area_1": "Mkhuhlu",
        121                "admin_area_2": "Mpumalanga",
        122                "postal_code": "8301",
        123                "country_code": "ZA",
        124                "type": "MAILING"
        125            }
        126        ],
        127        "identification_documents": [
        128            {
        129                "identification_number": "8000012050001",
        130                "issue_date": "2020-01-01",
        131                "issuing_country_code": "ZA",
        132                "type": "BUSINESS_REGISTRATION_NUMBER"
        133            }
        134        ],
        135        "incorporation_details": {
        136            "incorporation_country_code": "ZA",
        137            "incorporation_date": "2019-01-01",
        138            "incorporation_province_code": "O1"
        139        },
        140        "phone_numbers": [
        141            {
        142                "country_code": "27",
        143                "national_number": "3939249447",
        144                "type": "BUSINESS"
        145            }
        146        ],
        147        "beneficial_owners": {
        148            "individuals": [
        149                {
        150                    "percentage_of_ownership": "25",
        151                    "names": [
        152                        {
        153                            "type": "LEGAL",
        154                            "given_name": "MaryAPPROVED",
        155                            "surname": "Collins"
        156                        }
        157                    ],
        158                    "citizenship": "ZA",
        159                    "gender": "FEMALE",
        160                    "primary_residence": {
        161                        "address_line_1": "706 Ireland St",
        162                        "admin_area_1": "Mkhuhlu",
        163                        "admin_area_2": "Mpumalanga",
        164                        "postal_code": "8301",
        165                        "country_code": "ZA"
        166                    },
        167                    "tax_address": {
        168                        "address_line_1": "1681 Glyn St",
        169                        "admin_area_1": "Silverton",
        170                        "admin_area_2": "Gauteng",
        171                        "postal_code": "8301",
        172                        "country_code": "ZA"
        173                    },
        174                    "addresses": [
        175                        {
        176                            "type": "HOME",
        177                            "address_line_1": "Mkhuhlu",
        178                            "admin_area_1": "Mkhuhlu",
        179                            "admin_area_2": "Mpumalanga",
        180                            "postal_code": "8301",
        181                            "country_code": "ZA"
        182                        }
        183                    ],
        184                    "birth_details": {
        185                        "date_of_birth": "1960-01-01"
        186                    },
        187                    "identification_documents": [
        188                        {
        189                            "identification_number": "123456789",
        190                            "issue_date": "2020-01-01",
        191                            "expiry_date": "2025-01-01",
        192                            "issuing_country_code": "ZA",
        193                            "type": "PASSPORT"
        194                        }
        195                    ],
        196                    "emails": [
        197                        {
        198                            "email": "[email protected]"
        199                        }
        200                    ],
        201                    "agreements": [
        202                        {
        203                            "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
        204                            "accepted_time": "2019-06-02T01:23:45Z",
        205                            "signature": "Mary Collins"
        206                        }
        207                    ],
        208                    "declarations": [
        209                        {
        210                            "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
        211                            "value": "YES"
        212                        }
        213                    ]
        214                }
        215            ],
        216            "office_bearers": [
        217                {
        218                    "role": "CEO",
        219                    "names": [
        220                        {
        221                            "type": "LEGAL",
        222                            "given_name": "MaryAPPROVED",
        223                            "surname": "Collins"
        224                        }
        225                    ],
        226                    "citizenship": "ZA",
        227                    "gender": "FEMALE",
        228                    "primary_residence": {
        229                        "address_line_1": "Mkhuhlu",
        230                        "admin_area_1": "Mkhuhlu",
        231                        "admin_area_2": "Mpumalanga",
        232                        "postal_code": "8301",
        233                        "country_code": "ZA"
        234                    },
        235                    "tax_address": {
        236                        "address_line_1": "Silverton",
        237                        "admin_area_1": "Silverton",
        238                        "admin_area_2": "Gauteng",
        239                        "postal_code": "8301",
        240                        "country_code": "ZA"
        241                    },
        242                    "addresses": [
        243                        {
        244                            "type": "HOME",
        245                            "address_line_1": "Mkhuhlu",
        246                            "admin_area_1": "Mkhuhlu",
        247                            "admin_area_2": "Mpumalanga",
        248                            "postal_code": "8301",
        249                            "country_code": "ZA"
        250                        }
        251                    ],
        252                    "birth_details": {
        253                        "date_of_birth": "1960-01-01"
        254                    },
        255                    "identification_documents": [
        256                        {
        257                            "identification_number": "123456789",
        258                            "issue_date": "2020-01-01",
        259                            "expiry_date": "2025-01-01",
        260                            "issuing_country_code": "ZA",
        261                            "type": "PASSPORT"
        262                        }
        263                    ],
        264                    "emails": [
        265                        {
        266                            "email": "[email protected]"
        267                        }
        268                    ],
        269                    "agreements": [
        270                        {
        271                            "type": "FATCA_REPORTING_NOT_SUBJECT_TO_US_TAX_CERTIFICATION",
        272                            "accepted_time": "2019-06-02T01:23:45Z",
        273                            "signature": "Mary Collins"
        274                        }
        275                    ]
        276                }
        277            ]
        278        }
        279    },
        280    "agreements": [
        281        {
        282            "type": "TERMS_ACCEPTED",
        283            "accepted_time": "2019-06-02T01:23:45Z"
        284        }
        285    ]
        286}
        ReferencePayPal.comPrivacyCookiesSupportLegalContact

        如果您接受Cookie，我们将使用这些Cookie来改善并定制您的使用体验并允许合作伙伴在您访问其他网站时向您展示个性化的PayPal广告。管理Cookie并了解更多信息