Sample account creation requests

DocsCURRENT

Last updated: Jul 4th, 12:55am

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

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
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": "111@123.com"
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": "addBusinessEmail@provider.com"
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": "addEmail@126.com"
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": "addEmail@126.com"
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

Corporation
Individual
Nonprofit
Proprietorship
Public Company
Government
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

Corporation
Individual
Nonprofit
Proprietorship
Public Company
Government
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 show the account creation examples for the business types: Individual, Nonprofit, Government, and Corporation.

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

Individual
Nonprofit
Government
Corp - Owner Matches Roles
Corp - Owner does not match roles
Corp - >25% Beneficial Owner
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 table lists the different use case scenarios for business entities of type CORPORATION.

Merchant scenario	Required roles/conditions
Scenario 1 Merchant account of `CORPORATION` type where Individual Owner matches one of the roles	`individual_owner` name matches with one of the following roles: Business beneficial owner Authorized representation Account representation LOA (Letter of Authorization) is not required.
Scenario 2 Merchant account of `CORPORATION` type where Individual Owner does not match any roles	`individual_owner` name does not match any of the following roles: Business beneficial owner Authorized representation Account representation As a result, an LOA (Letter of Authorization) as an additional upload is required.
Scenario 3 Merchant account of `CORPORATION` type that has at least one Beneficial Owner who owns more than 25% of the business	There is one Beneficial Owner and one Office Bearer with a `AUTHORIZED_REPRESENTATIVE` role `AUTHORIZED_REPRESENTATIVE` is an official bearer with a `AUTHORIZED_REPRESENTATIVE` role Beneficial owner is provided `percentage_of_ownership` is not needed. We don't have to ask the partner to provide the percentage
Scenario 4 Merchant account of `CORPORATION` type with all the required data	There are two Office Bearers with the following roles: `AUTHORIZED_REPRESENTATIVE` `COMPANY_EXECUTIVE`

Indonesia

Sample requests

Corporation
Individual
Nonprofit
Proprietorship
Private Corporation
Public Company
Government
Association
Other Corporate Body
Partnership
Proprietory Company
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

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
Government
Association
Other Corporate Body
Partnership
Proprietory Company
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": "test_account_admin@paypal.com"
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": "test_account_admin_business@paypal.com"
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": "test_account_admin@paypal.com"
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": "test_account_admin@paypal.com"
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

Sample requests

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
Government
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

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
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": "test_account_admin@paypal.com"
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": "test_account_admin_business@paypal.com"
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": "test_account_admin@paypal.com"
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": "test_account_admin@paypal.com"
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

Sample requests

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
Government
Association
Other Corporate Body
Partnership
Proprietory Company
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

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
Government
Association
Other Corporate Body
Partnership
Proprietory Company
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

Sample full request
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": "test_account_admin@paypal.com"
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": "test_account_admin_business@paypal.com"
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": "test_account_admin@paypal.com"
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": "test_account_admin@paypal.com"
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

Sample requests

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
Government
Association
Partnership
Proprietory Company
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

Corporation
Individual
Nonprofit
Private Corporation
Proprietorship
Public Company
Government
Association
Other Corporate Body
Partnership
Proprietory Company
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": "test_account_admin@paypal.com"
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": "test_account_admin_business@paypal.com"
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": "test_account_admin@paypal.com"
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": "test_account_admin@paypal.com"
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}

Sample account creation requests

United States

Sample requests

European Union

Sample requests

Australia

Sample requests

Canada

Sample requests

Use-case scenarios - Corporation type

Indonesia

Sample requests

Sample responses

Maximum payload example

Japan

Sample requests

Sample responses

Maximum payload example

South Africa

Sample requests

Sample responses

Maximum payload example

United Arab Emirates

Sample requests

Sample responses

Maximum payload example

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more