Complete electronic and manual verification

CurrentDocs

Last updated: Oct 22nd, 1:24pm

The next steps to complete merchant onboarding are electronic and manual verification. Unlike data collection, you must monitor and respond to data verification requests for all the merchant accounts you create.

1

Monitor electronic verification webhooks

After creating a merchant account, you receive the CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED webhook, indicating that the verification process for your merchant has begun.

The webhook contains:

  • Account identifiers
  • A summary of the changes
  • A link to the GET call

After you receive a webhook, use your token to make a GET call to /v3/customer/managed-accounts/ACCOUNT-ID and pass the merchant's account id in ACCOUNT-ID.

  1. Request
  2. Response
1curl --location --request GET ‘{{host}}/v3/customer/managed-accounts/ACCOUNT-ID’ --header ‘Authorization: Bearer ACCESS-TOKEN’ --header 'Content-Type: application/json'

A successful request returns an HTTP 200 OK status code and a JSON response body. This body includes details of the submitted application information, the account's verification status, and a list of additional information or documentation required to complete the verification process.

2

Confirm electronic verification completion

Interpret the GET API response for the endpoint /v3/customer/managed-accounts/{id} to locate the capabilities array.

The response for this GET API request includes the capabilities array as a top-level entity. This array details the account's capabilities, current statuses, and associated payment processing limits. The API response returns various types of capabilities.

Capabilities

Definition

SEND_MONEY

Ability to send money as branded PayPal payments.

RECEIVE_MONEY

Ability to receive money as branded PayPal payments.

WITHDRAW_MONEY

Ability for a merchant to withdraw money directly to their bank account. This capability doesn't apply to partners using settlement consolidation.

CUSTOM_CARD_PROCESSING

Ability to receive card payments as an unbranded credit and debit card.

CUSTOM_BANK_PROCESSING

Ability to receive direct bank payments as unbranded bank payments.

APPLE_PAY

Ability to receive Apple Pay payments as unbranded wallet payments.

GOOGLE_PAY

Ability to receive Google Pay payments as unbranded wallet payments.

Sample response for successful electronic verification

If the electronic verification is successful, each capability has "status": "ACTIVE". If all capabilities have "status": "ACTIVE" and no limits associated with them, the merchant passes the electronic verification and requires no further action.

    1{
    2
    3 "account_id": "23PC3HNADFP2J",
    4
    5 "legal_country_code": "FR",
    6
    7 "individual_owners": [
    8
    9 {
    10
    11 "id": "23PC3HNADFP2J",
    12
    13 "names": [
    14
    15 {
    16
    17 "given_name": "Levin",
    18
    19 "surname": "Huang",
    20
    21 "id": "HAKBCPJRUZEP2",
    22
    23 "type": "LEGAL"
    24
    25 }
    26
    27 ],
    28
    29 "citizenship": "FR",
    30
    31 "primary_residence": {
    32
    33 "address_line_1": "24 rue du Faubourg Saint Honore",
    34
    35 "address_line_2": "Unit 2000",
    36
    37 "admin_area_2": "Paris",
    38
    39 "postal_code": "75008",
    40
    41 "country_code": "FR"
    42
    43 },
    44
    45 "phone_numbers": [
    46
    47 {
    48
    49 "country_code": "030",
    50
    51 "national_number": "6151175",
    52
    53 "id": "VB4FDVSH3KHGS",
    54
    55 "type": "MOBILE"
    56
    57 }
    58
    59 ],
    60
    61 "birth_details": {
    62
    63 "date_of_birth": "1995-08-01"
    64
    65 },
    66
    67 "identification_documents": [
    68
    69 {
    70
    71 "id": "9BMVHX9HM5H3G",
    72
    73 "identification_number": "****",
    74
    75 "issuing_country_code": "FR",
    76
    77 "type": "PASSPORT"
    78
    79 }
    80
    81 ],
    82
    83 "emails": [
    84
    85 {
    86
    87 "id": "C6Z86SFR4Q75J",
    88
    89 "email": "levin-personal-email@paypal.com"
    90
    91 }
    92
    93 ]
    94
    95 }
    96
    97 ],
    98
    99 "business_entity": {
    100
    101 "type": "CORPORATION",
    102
    103 "merchant_category_code": "5933",
    104
    105 "incorporation_details": {
    106
    107 "incorporation_country_code": "FR",
    108
    109 "incorporation_date": "1999-01-10"
    110
    111 },
    112
    113 "names": [
    114
    115 {
    116
    117 "business_name": "FINTECH UNICORN",
    118
    119 "id": "5JD67U874KZJY",
    120
    121 "type": "LEGAL"
    122
    123 }
    124
    125 ],
    126
    127 "emails": [
    128
    129 {
    130
    131 "id": "U4WENYWD5X7PU",
    132
    133 "email": "levin-business-email@paypal.com"
    134
    135 }
    136
    137 ],
    138
    139 "website": "https://developer.paypal.com/docs/multiparty/",
    140
    141 "registered_business_address": {
    142
    143 "address_line_1": "24 rue du Faubourg Saint Honore",
    144
    145 "address_line_2": "Unit 2100",
    146
    147 "admin_area_2": "Paris",
    148
    149 "postal_code": "75008",
    150
    151 "country_code": "FR"
    152
    153 },
    154
    155 "phone_numbers": [
    156
    157 {
    158
    159 "country_code": "1",
    160
    161 "national_number": "06151188",
    162
    163 "id": "HQE3JWM26N8UU",
    164
    165 "type": "BUSINESS"
    166
    167 }
    168
    169 ],
    170
    171 "identification_documents": [
    172
    173 {
    174
    175 "id": "42HL7HRQHT2JL",
    176
    177 "identification_number": "****",
    178
    179 "issuing_country_code": "FR",
    180
    181 "type": "BUSINESS_REGISTRATION_NUMBER"
    182
    183 }
    184
    185 ],
    186
    187 "declarations": [
    188
    189 {
    190
    191 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
    192
    193 "value": "NO"
    194
    195 }
    196
    197 ]
    198
    199 },
    200
    201 "agreements": [
    202
    203 {
    204
    205 "type": "TERMS_ACCEPTED",
    206
    207 "accepted_time": "2024-01-01T00:00:00Z"
    208
    209 }
    210
    211 ],
    212
    213 "external_id": "EXT-1707167597",
    214
    215 "organization": "us_org/net",
    216
    217 "user_id": "1707167597387",
    218
    219 "primary_currency_code": "EUR",
    220
    221 "soft_descriptor": "FINTECHUNIC",
    222
    223 "capabilities": [
    224
    225 {
    226
    227 "name": "APPLE_PAY",
    228
    229 "status": "ACTIVE"
    230
    231 },
    232
    233 {
    234
    235 "name": "GOOGLE_PAY",
    236
    237 "status": "ACTIVE"
    238
    239 },
    240
    241 {
    242
    243 "name": "CUSTOM_CARD_PROCESSING",
    244
    245 "status": "ACTIVE"
    246
    247 },
    248
    249 {
    250
    251 "name": "RECEIVE_MONEY",
    252
    253 "status": "ACTIVE"
    254
    255 },
    256
    257 {
    258
    259 "name": "WITHDRAW_MONEY",
    260
    261 "status": "ACTIVE"
    262
    263 }
    264
    265 ],
    266
    267 "process_view": {
    268
    269 "processes": [
    270
    271 {
    272
    273 "name": "MANAGED_PATH_CIP_COLLECTION",
    274
    275 "status": "COMPLETED",
    276
    277 "capabilities": [
    278
    279 {
    280
    281 "name": "RECEIVE_MONEY"
    282
    283 },
    284
    285 {
    286
    287 "name": "WITHDRAW_MONEY"
    288
    289 },
    290
    291 {
    292
    293 "name": "GOOGLE_PAY"
    294
    295 },
    296
    297 {
    298
    299 "name": "APPLE_PAY"
    300
    301 },
    302
    303 {
    304
    305 "name": "CUSTOM_CARD_PROCESSING"
    306
    307 }
    308
    309 ]
    310
    311 },
    312
    313 {
    314
    315 "name": "MANAGED_PATH_KYC",
    316
    317 "status": "COMPLETED",
    318
    319 "capabilities": [
    320
    321 {
    322
    323 "name": "WITHDRAW_MONEY"
    324
    325 },
    326
    327 {
    328
    329 "name": "CUSTOM_CARD_PROCESSING"
    330
    331 },
    332
    333 {
    334
    335 "name": "GOOGLE_PAY"
    336
    337 },
    338
    339 {
    340
    341 "name": "APPLE_PAY"
    342
    343 }
    344
    345 ]
    346
    347 }
    348
    349 ]
    350
    351 },
    352
    353 "links": [
    354
    355 {
    356
    357 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/23PC3HNADFP2J",
    358
    359 "rel": "self",
    360
    361 "method": "GET"
    362
    363 },
    364
    365 {
    366
    367 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/23PC3HNADFP2J",
    368
    369 "rel": "edit",
    370
    371 "method": "PATCH"
    372
    373 }
    374
    375 ]
    376
    377}

    Sample response when data is incomplete

    If the status is not "ACTIVE" or if there are "limits" displayed under the capability, the merchant still needs to pass the electronic verification.

      1{
      2 "account_id": "23PC3HNADFP2J",
      3 "legal_country_code": "FR",
      4 "individual_owners": [
      5 {
      6 "id": "23PC3HNADFP2J",
      7 "names": [
      8 {
      9 "given_name": "Levin",
      10 "surname": "Huang",
      11 "id": "HAKBCPJRUZEP2",
      12 "type": "LEGAL"
      13 }
      14 ],
      15 "citizenship": "FR",
      16 "primary_residence": {
      17 "address_line_1": "24 rue du Faubourg Saint Honore",
      18 "address_line_2": "Unit 2000",
      19 "admin_area_2": "Paris",
      20 "postal_code": "75008",
      21 "country_code": "FR"
      22 },
      23 "phone_numbers": [
      24 {
      25 "country_code": "030",
      26 "national_number": "6151175",
      27 "id": "VB4FDVSH3KHGS",
      28 "type": "MOBILE"
      29 }
      30 ],
      31 "birth_details": {
      32 "date_of_birth": "1995-08-01"
      33 },
      34 "identification_documents": [
      35 {
      36 "id": "9BMVHX9HM5H3G",
      37 "identification_number": "****",
      38 "issuing_country_code": "FR",
      39 "type": "PASSPORT"
      40 }
      41 ],
      42 "emails": [
      43 {
      44 "id": "C6Z86SFR4Q75J",
      45 "email": "levin-personal-email@paypal.com"
      46 }
      47 ]
      48 }
      49 ],
      50 "business_entity": {
      51 "type": "CORPORATION",
      52 "merchant_category_code": "5933",
      53 "incorporation_details": {
      54 "incorporation_country_code": "FR",
      55 "incorporation_date": "1999-01-10"
      56 },
      57 "names": [
      58 {
      59 "business_name": "FINTECH UNICORN",
      60 "id": "5JD67U874KZJY",
      61 "type": "LEGAL"
      62 }
      63 ],
      64 "emails": [
      65 {
      66 "id": "U4WENYWD5X7PU",
      67 "email": "levin-business-email@paypal.com"
      68 }
      69 ],
      70 "website": "https://developer.paypal.com/docs/multiparty/",
      71 "registered_business_address": {
      72 "address_line_1": "24 rue du Faubourg Saint Honore",
      73 "address_line_2": "Unit 2100",
      74 "admin_area_2": "Paris",
      75 "postal_code": "75008",
      76 "country_code": "FR"
      77 },
      78 "phone_numbers": [
      79 {
      80 "country_code": "1",
      81 "national_number": "06151188",
      82 "id": "HQE3JWM26N8UU",
      83 "type": "BUSINESS"
      84 }
      85 ],
      86 "identification_documents": [
      87 {
      88 "id": "42HL7HRQHT2JL",
      89 "identification_number": "****",
      90 "issuing_country_code": "FR",
      91 "type": "BUSINESS_REGISTRATION_NUMBER"
      92 }
      93 ],
      94 "declarations": [
      95 {
      96 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
      97 "value": "NO"
      98 }
      99 ]
      100 },
      101 "agreements": [
      102 {
      103 "type": "TERMS_ACCEPTED",
      104 "accepted_time": "2024-01-01T00:00:00Z"
      105 }
      106 ],
      107 "external_id": "EXT-1707167597",
      108 "organization": "us_org/net",
      109 "user_id": "1707167597387",
      110 "primary_currency_code": "EUR",
      111 "soft_descriptor": "FINTECHUNIC",
      112 "capabilities": [
      113 {
      114 "name": "APPLE_PAY",
      115 "limits": [
      116 {
      117 "type": "AMOUNT",
      118 "unit": "EUR",
      119 "value": "1000.00",
      120 "remaining_value": "1000.00",
      121 "implication_of_limit_breach": "START_GRACE_PERIOD"
      122 }
      123 ],
      124 "status": "ACTIVE"
      125 },
      126 {
      127 "name": "GOOGLE_PAY",
      128 "limits": [
      129 {
      130 "type": "AMOUNT",
      131 "unit": "EUR",
      132 "value": "1000.00",
      133 "remaining_value": "1000.00",
      134 "implication_of_limit_breach": "START_GRACE_PERIOD"
      135 }
      136 ],
      137 "status": "ACTIVE"
      138 },
      139 {
      140 "name": "CUSTOM_CARD_PROCESSING",
      141 "limits": [
      142 {
      143 "type": "AMOUNT",
      144 "unit": "EUR",
      145 "value": "1000.00",
      146 "remaining_value": "1000.00",
      147 "implication_of_limit_breach": "START_GRACE_PERIOD"
      148 }
      149 ],
      150 "status": "ACTIVE"
      151 },
      152 {
      153 "name": "RECEIVE_MONEY",
      154 "status": "ACTIVE"
      155 },
      156 {
      157 "name": "WITHDRAW_MONEY",
      158 "limits": [
      159 {
      160 "type": "AMOUNT",
      161 "unit": "EUR",
      162 "value": "1000.00",
      163 "remaining_value": "1000.00",
      164 "implication_of_limit_breach": "BLOCK_CAPABILITY"
      165 }
      166 ],
      167 "status": "ACTIVE"
      168 }
      169 ],
      170 "process_view": {
      171 "processes": [
      172 {
      173 "name": "MANAGED_PATH_CIP_COLLECTION",
      174 "status": "COMPLETED",
      175 "capabilities": [
      176 {
      177 "name": "RECEIVE_MONEY"
      178 },
      179 {
      180 "name": "WITHDRAW_MONEY"
      181 },
      182 {
      183 "name": "GOOGLE_PAY"
      184 },
      185 {
      186 "name": "APPLE_PAY"
      187 },
      188 {
      189 "name": "CUSTOM_CARD_PROCESSING"
      190 }
      191 ]
      192 },
      193 {
      194 "name": "MANAGED_PATH_KYC",
      195 "status": "NEED_MORE_DATA",
      196 "capabilities": [
      197 {
      198 "name": "WITHDRAW_MONEY",
      199 "limits": [
      200 {
      201 "type": "AMOUNT",
      202 "unit": "EUR",
      203 "value": "1000.00",
      204 "remaining_value": "1000.00",
      205 "implication_of_limit_breach": "BLOCK_CAPABILITY"
      206 }
      207 ]
      208 },
      209 {
      210 "name": "CUSTOM_CARD_PROCESSING",
      211 "limits": [
      212 {
      213 "type": "AMOUNT",
      214 "unit": "EUR",
      215 "value": "1000.00",
      216 "remaining_value": "1000.00",
      217 "implication_of_limit_breach": "START_GRACE_PERIOD"
      218 }
      219 ]
      220 },
      221 {
      222 "name": "GOOGLE_PAY",
      223 "limits": [
      224 {
      225 "type": "AMOUNT",
      226 "unit": "EUR",
      227 "value": "1000.00",
      228 "remaining_value": "1000.00",
      229 "implication_of_limit_breach": "START_GRACE_PERIOD"
      230 }
      231 ]
      232 },
      233 {
      234 "name": "APPLE_PAY",
      235 "limits": [
      236 {
      237 "type": "AMOUNT",
      238 "unit": "EUR",
      239 "value": "1000.00",
      240 "remaining_value": "1000.00",
      241 "implication_of_limit_breach": "START_GRACE_PERIOD"
      242 }
      243 ]
      244 }
      245 ],
      246 "required": {
      247 "op": "ALL_OF",
      248 "attributes": [
      249 {
      250 "op": "ONE_OF",
      251 "attributes": [
      252 {
      253 "op": "ALL_OF",
      254 "attributes": [
      255 "$.business_entity.office_bearers[?(@['role']=='CEO')].citizenship",
      256 "$.business_entity.office_bearers[?(@['role']=='CEO')].names[?(@['type']=='LEGAL')]",
      257 "$.business_entity.office_bearers[?(@['role']=='CEO')].birth_details.date_of_birth",
      258 "$.business_entity.office_bearers[?(@['role']=='CEO')].addresses[?(@['type']=='HOME')]"
      259 ]
      260 },
      261 {
      262 "op": "ALL_OF",
      263 "attributes": [
      264 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].citizenship",
      265 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].names[?(@['type']=='LEGAL')]",
      266 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].birth_details.date_of_birth",
      267 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].addresses[?(@['type']=='HOME')]"
      268 ]
      269 },
      270 {
      271 "op": "ALL_OF",
      272 "attributes": [
      273 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].citizenship",
      274 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].names[?(@['type']=='LEGAL')]",
      275 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].birth_details.date_of_birth",
      276 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].addresses[?(@['type']=='HOME')]"
      277 ]
      278 },
      279 {
      280 "op": "ALL_OF",
      281 "attributes": [
      282 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].citizenship",
      283 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].names[?(@['type']=='LEGAL')]",
      284 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].birth_details.date_of_birth",
      285 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].addresses[?(@['type']=='HOME')]"
      286 ]
      287 },
      288 {
      289 "op": "ALL_OF",
      290 "attributes": [
      291 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].citizenship",
      292 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].percentage_of_ownership",
      293 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].names[?(@['type']=='LEGAL')]",
      294 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].birth_details.date_of_birth",
      295 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].addresses[?(@['type']=='HOME')]"
      296 ]
      297 },
      298 {
      299 "op": "ALL_OF",
      300 "attributes": [
      301 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].citizenship",
      302 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].names[?(@['type']=='LEGAL')]",
      303 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].birth_details.date_of_birth",
      304 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].addresses[?(@['type']=='HOME')]"
      305 ]
      306 }
      307 ]
      308 },
      309 "$.business_entity.office_bearers[?(@['role']=='DIRECTOR')].citizenship",
      310 "$.business_entity.office_bearers[?(@['role']=='DIRECTOR')].names[?(@['type']=='LEGAL')]",
      311 "$.business_entity.office_bearers[?(@['role']=='DIRECTOR')].birth_details.date_of_birth"
      312 ]
      313 }
      314 }
      315 ]
      316 },
      317 "links": [
      318 {
      319 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/23PC3HNADFP2J",
      320 "rel": "self",
      321 "method": "GET"
      322 },
      323 {
      324 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/23PC3HNADFP2J",
      325 "rel": "edit",
      326 "method": "PATCH"
      327 }
      328 ]
      329}

      Limits on Capabilities

      In the United States, merchants conduct transactions up to specified amounts even if they fail electronic verification. If the capabilities array in the response shows a limit, the merchant can still use the capability with limits despite failing the electronic verification.

      The limit in the response includes both the total limit amount and the remaining amount. If there is a time limit associated with the limit, the grace_periods array lists the start and end times of the grace period.

      Sample response for initial e-KYC attempt with $1000 limit

        1{
        2 "account_id": "USZJERXL88TDL",
        3 "legal_country_code": "FR",
        4 "individual_owners": [
        5 {
        6 "id": "USZJERXL88TDL",
        7 "names": [
        8 {
        9 "given_name": "Levin",
        10 "surname": "Huang",
        11 "id": "5YQX3KBKL7T4S",
        12 "type": "LEGAL"
        13 }
        14 ],
        15 "citizenship": "FR",
        16 "primary_residence": {
        17 "address_line_1": "24 rue du Faubourg Saint Honore",
        18 "address_line_2": "Unit 2000",
        19 "admin_area_2": "Paris",
        20 "postal_code": "75008",
        21 "country_code": "FR"
        22 },
        23 "phone_numbers": [
        24 {
        25 "country_code": "030",
        26 "national_number": "6151175",
        27 "id": "WNBMJ2MH49GV8",
        28 "type": "MOBILE"
        29 }
        30 ],
        31 "birth_details": {
        32 "date_of_birth": "1995-08-01"
        33 },
        34 "identification_documents": [
        35 {
        36 "id": "XVZWDF8XJ4E56",
        37 "identification_number": "****",
        38 "issuing_country_code": "FR",
        39 "type": "PASSPORT"
        40 }
        41 ],
        42 "emails": [
        43 {
        44 "id": "ZGQNPZAHLT2M2",
        45 "email": "levin-personal-email@paypal.com"
        46 }
        47 ]
        48 }
        49 ],
        50 "business_entity": {
        51 "type": "CORPORATION",
        52 "merchant_category_code": "5933",
        53 "incorporation_details": {
        54 "incorporation_country_code": "FR",
        55 "incorporation_date": "1999-01-10"
        56 },
        57 "names": [
        58 {
        59 "business_name": "Fintech Unicorn",
        60 "id": "JYP26SH5ZMRS2",
        61 "type": "LEGAL"
        62 }
        63 ],
        64 "emails": [
        65 {
        66 "id": "EMHQK8MS2E5HL",
        67 "email": "levin-business-email@paypal.com"
        68 }
        69 ],
        70 "website": "https://developer.paypal.com/docs/multiparty/",
        71 "registered_business_address": {
        72 "address_line_1": "24 rue du Faubourg Saint Honore",
        73 "address_line_2": "Unit 2100",
        74 "admin_area_2": "Paris",
        75 "postal_code": "75008",
        76 "country_code": "FR"
        77 },
        78 "phone_numbers": [
        79 {
        80 "country_code": "1",
        81 "national_number": "06151188",
        82 "id": "PGYBZUPJAD6D2",
        83 "type": "BUSINESS"
        84 }
        85 ],
        86 "identification_documents": [
        87 {
        88 "id": "QHQ8W2T3DN4V2",
        89 "identification_number": "****",
        90 "issuing_country_code": "FR",
        91 "type": "BUSINESS_REGISTRATION_NUMBER"
        92 }
        93 ],
        94 "beneficial_owners": {
        95 "individuals": [
        96 {
        97 "id": "UJGR6DTJH5QDS",
        98 "names": [
        99 {
        100 "given_name": "Lucas",
        101 "surname": "Li",
        102 "id": "JP8BTRPBFJJSY",
        103 "type": "LEGAL"
        104 }
        105 ],
        106 "citizenship": "FR",
        107 "addresses": [
        108 {
        109 "address_line_1": "24 rue du Faubourg Saint Honore",
        110 "address_line_2": "Unit 2200",
        111 "admin_area_2": "Paris",
        112 "postal_code": "75008",
        113 "country_code": "FR",
        114 "id": "XHNHA4FR9EXZL",
        115 "type": "HOME"
        116 }
        117 ],
        118 "phone_numbers": [
        119 {
        120 "country_code": "1",
        121 "national_number": "06151188",
        122 "id": "DX29KCM3BQ88C",
        123 "type": "WORK"
        124 }
        125 ],
        126 "birth_details": {
        127 "date_of_birth": "1990-01-01"
        128 },
        129 "identification_documents": [
        130 {
        131 "id": "U2TQ26HZQCDQG",
        132 "identification_number": "****",
        133 "issuing_country_code": "FR",
        134 "type": "NATIONAL_ID_CARD"
        135 }
        136 ],
        137 "emails": [
        138 {
        139 "email": "lucas-personal-email@gmail.com"
        140 }
        141 ],
        142 "percentage_of_ownership": "30",
        143 "controlling_influence": false
        144 }
        145 ]
        146 },
        147 "office_bearers": [
        148 {
        149 "id": "FDT34KT4KHJQG",
        150 "names": [
        151 {
        152 "given_name": "Alexei",
        153 "surname": "Coreiba",
        154 "id": "TE9Z2AG96NSY6",
        155 "type": "LEGAL"
        156 }
        157 ],
        158 "citizenship": "FR",
        159 "addresses": [
        160 {
        161 "address_line_1": "24 rue du Faubourg Saint Honore",
        162 "address_line_2": "Unit 2300",
        163 "admin_area_2": "Paris",
        164 "postal_code": "75008",
        165 "country_code": "FR",
        166 "id": "VXL3PNNNS8566",
        167 "type": "HOME"
        168 }
        169 ],
        170 "phone_numbers": [
        171 {
        172 "country_code": "1",
        173 "national_number": "06151188",
        174 "id": "FVYF6MMJC2J58",
        175 "type": "WORK"
        176 }
        177 ],
        178 "birth_details": {
        179 "date_of_birth": "1990-01-01"
        180 },
        181 "identification_documents": [
        182 {
        183 "id": "WL5V3MZ53KPDE",
        184 "identification_number": "****",
        185 "issuing_country_code": "FR",
        186 "type": "PASSPORT"
        187 }
        188 ],
        189 "emails": [
        190 {
        191 "email": "alexei-email@gmail.com"
        192 }
        193 ],
        194 "role": "DIRECTOR"
        195 }
        196 ],
        197 "declarations": [
        198 {
        199 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
        200 "value": "YES"
        201 }
        202 ]
        203 },
        204 "agreements": [
        205 {
        206 "type": "TERMS_ACCEPTED",
        207 "accepted_time": "2024-01-01T00:00:00Z"
        208 }
        209 ],
        210 "balances": [
        211 {
        212 "available_balances": [
        213 {
        214 "currency_code": "EUR",
        215 "value": "0.00"
        216 }
        217 ],
        218 "available": {
        219 "currency_code": "EUR",
        220 "value": "0.00"
        221 },
        222 "reserved": {
        223 "currency_code": "EUR",
        224 "value": "0.00"
        225 }
        226 }
        227 ],
        228 "external_id": "EXT-1707163925",
        229 "organization": "us_org/net",
        230 "user_id": "1707163924527",
        231 "primary_currency_code": "EUR",
        232 "soft_descriptor": "FINTECHUNICORN",
        233 "capabilities": [
        234 {
        235 "name": "APPLE_PAY",
        236 "limits": [
        237 {
        238 "type": "AMOUNT",
        239 "unit": "EUR",
        240 "value": "1000.00",
        241 "remaining_value": "1000.00",
        242 "implication_of_limit_breach": "START_GRACE_PERIOD"
        243 }
        244 ],
        245 "status": "ACTIVE"
        246 },
        247 {
        248 "name": "GOOGLE_PAY",
        249 "limits": [
        250 {
        251 "type": "AMOUNT",
        252 "unit": "EUR",
        253 "value": "1000.00",
        254 "remaining_value": "1000.00",
        255 "implication_of_limit_breach": "START_GRACE_PERIOD"
        256 }
        257 ],
        258 "status": "ACTIVE"
        259 },
        260 {
        261 "name": "CUSTOM_CARD_PROCESSING",
        262 "limits": [
        263 {
        264 "type": "AMOUNT",
        265 "unit": "EUR",
        266 "value": "1000.00",
        267 "remaining_value": "1000.00",
        268 "implication_of_limit_breach": "START_GRACE_PERIOD"
        269 }
        270 ],
        271 "status": "ACTIVE"
        272 },
        273 {
        274 "name": "RECEIVE_MONEY",
        275 "status": "ACTIVE"
        276 },
        277 {
        278 "name": "WITHDRAW_MONEY",
        279 "limits": [
        280 {
        281 "type": "AMOUNT",
        282 "unit": "EUR",
        283 "value": "1000.00",
        284 "remaining_value": "1000.00",
        285 "implication_of_limit_breach": "BLOCK_CAPABILITY"
        286 }
        287 ],
        288 "status": "ACTIVE"
        289 }
        290 ],
        291 "process_view": {
        292 "processes": [
        293 {
        294 "name": "MANAGED_PATH_KYC",
        295 "status": "NEED_MORE_DATA",
        296 "capabilities": [
        297 {
        298 "name": "GOOGLE_PAY",
        299 "limits": [
        300 {
        301 "type": "AMOUNT",
        302 "unit": "EUR",
        303 "value": "1000.00",
        304 "remaining_value": "1000.00",
        305 "implication_of_limit_breach": "START_GRACE_PERIOD"
        306 }
        307 ]
        308 },
        309 {
        310 "name": "CUSTOM_CARD_PROCESSING",
        311 "limits": [
        312 {
        313 "type": "AMOUNT",
        314 "unit": "EUR",
        315 "value": "1000.00",
        316 "remaining_value": "1000.00",
        317 "implication_of_limit_breach": "START_GRACE_PERIOD"
        318 }
        319 ]
        320 },
        321 {
        322 "name": "APPLE_PAY",
        323 "limits": [
        324 {
        325 "type": "AMOUNT",
        326 "unit": "EUR",
        327 "value": "1000.00",
        328 "remaining_value": "1000.00",
        329 "implication_of_limit_breach": "START_GRACE_PERIOD"
        330 }
        331 ]
        332 },
        333 {
        334 "name": "WITHDRAW_MONEY",
        335 "limits": [
        336 {
        337 "type": "AMOUNT",
        338 "unit": "EUR",
        339 "value": "1000.00",
        340 "remaining_value": "1000.00",
        341 "implication_of_limit_breach": "BLOCK_CAPABILITY"
        342 }
        343 ]
        344 }
        345 ],
        346 "required_corrections": {
        347 "op": "ALL_OF",
        348 "attributes": [
        349 "$.business_entity.type",
        350 "$.business_entity.identification_documents[?(@['type']=='BUSINESS_REGISTRATION_NUMBER')]",
        351 "$.business_entity.registered_business_address",
        352 "$.business_entity.names[?(@['type']=='LEGAL')]"
        353 ]
        354 }
        355 },
        356 {
        357 "name": "MANAGED_PATH_CIP_COLLECTION",
        358 "status": "COMPLETED",
        359 "capabilities": [
        360 {
        361 "name": "APPLE_PAY"
        362 },
        363 {
        364 "name": "RECEIVE_MONEY"
        365 },
        366 {
        367 "name": "GOOGLE_PAY"
        368 },
        369 {
        370 "name": "CUSTOM_CARD_PROCESSING"
        371 },
        372 {
        373 "name": "WITHDRAW_MONEY"
        374 }
        375 ]
        376 }
        377 ]
        378 },
        379 "links": [
        380 {
        381 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL",
        382 "rel": "self",
        383 "method": "GET"
        384 },
        385 {
        386 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL",
        387 "rel": "edit",
        388 "method": "PATCH"
        389 },
        390 {
        391 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL/wallet-domains?page=1",
        392 "rel": "wallet-domains",
        393 "method": "GET"
        394 }
        395 ]
        396}

        The types of limits may vary based on the country.

        Limits in the US

        Know Your Customer (KYC) and Beneficial Owner (BO) data collection and verification is mandatory in the US. If these checks don't pass, PayPal places different limits on the account.

        Process Name

        Name as it appears in the API

        Restriction

        KYC Verification

        MANAGED_PATH_KYC_VERIFICATION

        PayPal blocks all withdrawals and limits the cumulative amount received to $5,000.00 in transactions or 30 days from the account creation date, whichever comes first.

        Beneficial Owner Verification

        MANAGED_PATH_BO_VERIFICATION

        PayPal limits the cumulative amount received in transactions to $5,000.00. PayPal blocks all withdrawals and transactions after the merchant account reaches this limit.

        The Know Your Customer (KYC) and Beneficial Ownership (BO) procedures are standard verification processes that ensure compliance with local regulations. For Beneficial Ownership verification, all business stakeholders associated with the business, such as beneficial owners and Control Prong representatives, submit data for verification.

        This process applies to all legal business entities except government entities and public companies.

        PayPal must verify:

        • Ownership Prong (Beneficial Owners): Up to 4 individuals who own 25% or more of the business, directly or indirectly.
        • Control Prong (Office Bearers): 1 person who controls the business's day-to-day operations, such as C-level executives or someone authorized to make decisions on behalf of the business.

        Sample response for account with $5000 limit

          1{
          2 "account_id": "5J5BPEQEWPT9W",
          3 "legal_country_code": "US",
          4 "individual_owners": [
          5 {
          6 "id": "5J5BPEQEWPT9W",
          7 "names": [
          8 {
          9 "given_name": "Levin",
          10 "surname": "Huang",
          11 "id": "3C7DGY7398H8S",
          12 "type": "LEGAL"
          13 }
          14 ],
          15 "citizenship": "US",
          16 "primary_residence": {
          17 "address_line_1": "2211 N First St ",
          18 "address_line_2": "Unit 2000",
          19 "admin_area_2": "San Jose",
          20 "admin_area_1": "CA",
          21 "postal_code": "95134",
          22 "country_code": "US"
          23 },
          24 "phone_numbers": [
          25 {
          26 "country_code": "030",
          27 "national_number": "6151175",
          28 "id": "JUXDGWSN5FVMU",
          29 "type": "MOBILE"
          30 }
          31 ],
          32 "birth_details": {
          33 "date_of_birth": "1995-08-01"
          34 },
          35 "identification_documents": [
          36 {
          37 "id": "F8W3FY42CQ7RE",
          38 "identification_number": "****",
          39 "issuing_country_code": "US",
          40 "type": "SOCIAL_SECURITY_NUMBER"
          41 }
          42 ],
          43 "emails": [
          44 {
          45 "id": "WDK3MDC9WL29N",
          46 "email": "levin-personal-email@paypal.com"
          47 }
          48 ]
          49 }
          50 ],
          51 "business_entity": {
          52 "type": "CORPORATION",
          53 "merchant_category_code": "5933",
          54 "incorporation_details": {},
          55 "names": [
          56 {
          57 "business_name": "Fintech Unicorn",
          58 "id": "GRYKNEVWFK9EW",
          59 "type": "LEGAL"
          60 }
          61 ],
          62 "emails": [
          63 {
          64 "id": "78ABNEKQVAT8S",
          65 "email": "levin-business-email@paypal.com"
          66 }
          67 ],
          68 "website_info": {
          69 "website_exists": true,
          70 "website_url": "https://developer.paypal.com/docs/multiparty/"
          71 },
          72 "registered_business_address": {
          73 "address_line_1": "2211 N First St ",
          74 "address_line_2": "Unit 1300",
          75 "admin_area_2": "San Jose",
          76 "admin_area_1": "CA",
          77 "postal_code": "95134",
          78 "country_code": "US"
          79 },
          80 "phone_numbers": [
          81 {
          82 "country_code": "1",
          83 "national_number": "06151188",
          84 "id": "LYBZFCBJKKQRQ",
          85 "type": "BUSINESS"
          86 }
          87 ],
          88 "identification_documents": [
          89 {
          90 "id": "ACXWRURL73MB6",
          91 "identification_number": "****",
          92 "issuing_country_code": "US",
          93 "type": "EMPLOYER_IDENTIFICATION_NUMBER"
          94 }
          95 ],
          96 "beneficial_owners": {
          97 "individuals": [
          98 {
          99 "id": "2EP33U5BZK2XY",
          100 "names": [
          101 {
          102 "given_name": "Lucas",
          103 "surname": "Li",
          104 "id": "6T4P6E74PPJXJ",
          105 "type": "LEGAL"
          106 }
          107 ],
          108 "citizenship": "US",
          109 "addresses": [
          110 {
          111 "address_line_1": "2211 N First St ",
          112 "address_line_2": "Unit 2100",
          113 "admin_area_2": "San Jose",
          114 "admin_area_1": "CA",
          115 "postal_code": "95134",
          116 "country_code": "US",
          117 "id": "9WX6RX44J9W9U",
          118 "type": "HOME"
          119 }
          120 ],
          121 "phone_numbers": [
          122 {
          123 "country_code": "1",
          124 "national_number": "06151188",
          125 "id": "M9W369B3KN85W",
          126 "type": "WORK"
          127 }
          128 ],
          129 "birth_details": {
          130 "date_of_birth": "1990-01-01"
          131 },
          132 "identification_documents": [
          133 {
          134 "id": "4HRQRUY8WYSQC",
          135 "identification_number": "****",
          136 "issuing_country_code": "US",
          137 "type": "SOCIAL_SECURITY_NUMBER"
          138 }
          139 ],
          140 "emails": [
          141 {
          142 "email": "lucas-personal-email@gmail.com"
          143 }
          144 ],
          145 "percentage_of_ownership": "30",
          146 "controlling_influence": false
          147 }
          148 ]
          149 },
          150 "office_bearers": [
          151 {
          152 "id": "UEHFS3WLU8QPL",
          153 "names": [
          154 {
          155 "given_name": "Alexei",
          156 "surname": "Coreiba",
          157 "id": "YVJS8CBDXY5JS",
          158 "type": "LEGAL"
          159 }
          160 ],
          161 "citizenship": "US",
          162 "addresses": [
          163 {
          164 "address_line_1": "2211 N First St ",
          165 "address_line_2": "Unit 2123",
          166 "admin_area_2": "San Jose",
          167 "admin_area_1": "CA",
          168 "postal_code": "95134",
          169 "country_code": "US",
          170 "id": "WUXE77KTMRNLQ",
          171 "type": "HOME"
          172 }
          173 ],
          174 "phone_numbers": [
          175 {
          176 "country_code": "1",
          177 "national_number": "06151188",
          178 "id": "VY6DGWL3CDWHU",
          179 "type": "WORK"
          180 }
          181 ],
          182 "birth_details": {
          183 "date_of_birth": "1990-01-01"
          184 },
          185 "identification_documents": [
          186 {
          187 "id": "NCAC2QC27V5B8",
          188 "identification_number": "****",
          189 "issuing_country_code": "US",
          190 "type": "SOCIAL_SECURITY_NUMBER"
          191 }
          192 ],
          193 "emails": [
          194 {
          195 "email": "alexei-email@gmail.com"
          196 }
          197 ]
          198 }
          199 ],
          200 "declarations": [
          201 {
          202 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
          203 "value": "YES"
          204 }
          205 ]
          206 },
          207 "agreements": [
          208 {
          209 "type": "TERMS_ACCEPTED",
          210 "accepted_time": "2024-01-01T00:00:00Z"
          211 }
          212 ],
          213 "balances": [
          214 {
          215 "available_balances": [
          216 {
          217 "currency_code": "USD",
          218 "value": "0.00"
          219 }
          220 ],
          221 "available": {
          222 "currency_code": "USD",
          223 "value": "0.00"
          224 },
          225 "reserved": {
          226 "currency_code": "USD",
          227 "value": "0.00"
          228 }
          229 }
          230 ],
          231 "external_id": "EXT-1707161355",
          232 "organization": "us_org/net",
          233 "user_id": "1707161354908",
          234 "primary_currency_code": "USD",
          235 "soft_descriptor": "FINTECHUNICORN",
          236 "capabilities": [
          237 {
          238 "name": "APPLE_PAY",
          239 "limits": [
          240 {
          241 "type": "AMOUNT",
          242 "unit": "USD",
          243 "value": "5000.00",
          244 "remaining_value": "5000.00",
          245 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          246 }
          247 ],
          248 "grace_periods": [
          249 {
          250 "start_time": "2024-02-05T19:29:41.963Z",
          251 "expiry_time": "2024-03-06T19:29:41.963Z"
          252 }
          253 ],
          254 "status": "ACTIVE"
          255 },
          256 {
          257 "name": "GOOGLE_PAY",
          258 "limits": [
          259 {
          260 "type": "AMOUNT",
          261 "unit": "USD",
          262 "value": "5000.00",
          263 "remaining_value": "5000.00",
          264 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          265 }
          266 ],
          267 "grace_periods": [
          268 {
          269 "start_time": "2024-02-05T19:29:41.963Z",
          270 "expiry_time": "2024-03-06T19:29:41.963Z"
          271 }
          272 ],
          273 "status": "ACTIVE"
          274 },
          275 {
          276 "name": "CUSTOM_CARD_PROCESSING",
          277 "limits": [
          278 {
          279 "type": "AMOUNT",
          280 "unit": "USD",
          281 "value": "5000.00",
          282 "remaining_value": "5000.00",
          283 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          284 }
          285 ],
          286 "grace_periods": [
          287 {
          288 "start_time": "2024-02-05T19:29:41.963Z",
          289 "expiry_time": "2024-03-06T19:29:41.963Z"
          290 }
          291 ],
          292 "status": "ACTIVE"
          293 },
          294 {
          295 "name": "RECEIVE_MONEY",
          296 "limits": [
          297 {
          298 "type": "AMOUNT",
          299 "unit": "USD",
          300 "value": "5000.00",
          301 "remaining_value": "5000.00",
          302 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          303 }
          304 ],
          305 "grace_periods": [
          306 {
          307 "start_time": "2024-02-05T19:29:41.963Z",
          308 "expiry_time": "2024-03-06T19:29:41.963Z"
          309 }
          310 ],
          311 "status": "ACTIVE"
          312 },
          313 {
          314 "name": "WITHDRAW_MONEY",
          315 "status": "NEED_DATA"
          316 }
          317 ],
          318 "process_view": {
          319 "processes": [
          320 {
          321 "name": "MANAGED_PATH_KYC_VERIFICATION",
          322 "status": "NEED_MORE_DATA",
          323 "capabilities": [
          324 {
          325 "name": "CUSTOM_CARD_PROCESSING",
          326 "limits": [
          327 {
          328 "type": "AMOUNT",
          329 "unit": "USD",
          330 "value": "5000.00",
          331 "remaining_value": "5000.00",
          332 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          333 }
          334 ],
          335 "grace_periods": [
          336 {
          337 "start_time": "2024-02-05T19:29:41.963Z",
          338 "expiry_time": "2024-03-06T19:29:41.963Z"
          339 }
          340 ]
          341 },
          342 {
          343 "name": "RECEIVE_MONEY",
          344 "limits": [
          345 {
          346 "type": "AMOUNT",
          347 "unit": "USD",
          348 "value": "5000.00",
          349 "remaining_value": "5000.00",
          350 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          351 }
          352 ],
          353 "grace_periods": [
          354 {
          355 "start_time": "2024-02-05T19:29:41.963Z",
          356 "expiry_time": "2024-03-06T19:29:41.963Z"
          357 }
          358 ]
          359 },
          360 {
          361 "name": "WITHDRAW_MONEY"
          362 },
          363 {
          364 "name": "APPLE_PAY",
          365 "limits": [
          366 {
          367 "type": "AMOUNT",
          368 "unit": "USD",
          369 "value": "5000.00",
          370 "remaining_value": "5000.00",
          371 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          372 }
          373 ],
          374 "grace_periods": [
          375 {
          376 "start_time": "2024-02-05T19:29:41.963Z",
          377 "expiry_time": "2024-03-06T19:29:41.963Z"
          378 }
          379 ]
          380 },
          381 {
          382 "name": "GOOGLE_PAY",
          383 "limits": [
          384 {
          385 "type": "AMOUNT",
          386 "unit": "USD",
          387 "value": "5000.00",
          388 "remaining_value": "5000.00",
          389 "implication_of_limit_breach": "BLOCK_CAPABILITY"
          390 }
          391 ],
          392 "grace_periods": [
          393 {
          394 "start_time": "2024-02-05T19:29:41.963Z",
          395 "expiry_time": "2024-03-06T19:29:41.963Z"
          396 }
          397 ]
          398 }
          399 ],
          400 "required": {
          401 "op": "ALL_OF",
          402 "attributes": [
          403 {
          404 "op": "ONE_OF",
          405 "attributes": [
          406 "22045",
          407 "7a796",
          408 "173f8",
          409 "2fbb0",
          410 "72bba"
          411 ]
          412 },
          413 {
          414 "op": "ONE_OF",
          415 "attributes": [
          416 "1a833",
          417 "1c10c",
          418 "b7604",
          419 "27580"
          420 ]
          421 },
          422 "6809d"
          423 ]
          424 }
          425 },
          426 {
          427 "name": "MANAGED_PATH_BO_VERIFICATION",
          428 "status": "COMPLETED",
          429 "capabilities": [
          430 {
          431 "name": "WITHDRAW_MONEY"
          432 },
          433 {
          434 "name": "RECEIVE_MONEY"
          435 },
          436 {
          437 "name": "APPLE_PAY"
          438 },
          439 {
          440 "name": "GOOGLE_PAY"
          441 },
          442 {
          443 "name": "CUSTOM_CARD_PROCESSING"
          444 }
          445 ]
          446 },
          447 {
          448 "name": "MANAGED_PATH_KYC_COLLECTION",
          449 "status": "COMPLETED",
          450 "capabilities": [
          451 {
          452 "name": "RECEIVE_MONEY"
          453 },
          454 {
          455 "name": "WITHDRAW_MONEY"
          456 },
          457 {
          458 "name": "GOOGLE_PAY"
          459 },
          460 {
          461 "name": "CUSTOM_CARD_PROCESSING"
          462 },
          463 {
          464 "name": "APPLE_PAY"
          465 }
          466 ]
          467 },
          468 {
          469 "name": "MANAGED_PATH_BO_COLLECTION",
          470 "status": "COMPLETED",
          471 "capabilities": [
          472 {
          473 "name": "GOOGLE_PAY"
          474 },
          475 {
          476 "name": "APPLE_PAY"
          477 },
          478 {
          479 "name": "WITHDRAW_MONEY"
          480 },
          481 {
          482 "name": "CUSTOM_CARD_PROCESSING"
          483 },
          484 {
          485 "name": "RECEIVE_MONEY"
          486 }
          487 ]
          488 }
          489 ],
          490 "required_documents": [
          491 {
          492 "id": "6809d",
          493 "name": "BUSINESS_EXISTENCE",
          494 "entity": "$.business_entity",
          495 "links": [
          496 {
          497 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          498 "rel": "upload",
          499 "method": "POST"
          500 }
          501 ]
          502 },
          503 {
          504 "id": "72bba",
          505 "name": "BUSINESS_LICENSE",
          506 "entity": "$.business_entity",
          507 "links": [
          508 {
          509 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          510 "rel": "upload",
          511 "method": "POST"
          512 }
          513 ]
          514 },
          515 {
          516 "id": "27580",
          517 "name": "USIRS_EIN_ALLOCATION_LETTER",
          518 "entity": "$.business_entity",
          519 "links": [
          520 {
          521 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          522 "rel": "upload",
          523 "method": "POST"
          524 }
          525 ]
          526 },
          527 {
          528 "id": "b7604",
          529 "name": "BUSINESS_INCOME_TAX_RETURN",
          530 "entity": "$.business_entity",
          531 "links": [
          532 {
          533 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          534 "rel": "upload",
          535 "method": "POST"
          536 }
          537 ]
          538 },
          539 {
          540 "id": "22045",
          541 "name": "TAX_ASSESSMENT_NOTICE",
          542 "entity": "$.business_entity",
          543 "links": [
          544 {
          545 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          546 "rel": "upload",
          547 "method": "POST"
          548 }
          549 ]
          550 },
          551 {
          552 "id": "7a796",
          553 "name": "UTILITIES_BILL",
          554 "entity": "$.business_entity",
          555 "links": [
          556 {
          557 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          558 "rel": "upload",
          559 "method": "POST"
          560 }
          561 ]
          562 },
          563 {
          564 "id": "1a833",
          565 "name": "USIRS_NAME_CHANGE_LETTER",
          566 "entity": "$.business_entity",
          567 "links": [
          568 {
          569 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          570 "rel": "upload",
          571 "method": "POST"
          572 }
          573 ]
          574 },
          575 {
          576 "id": "173f8",
          577 "name": "INSURANCE_STATEMENT",
          578 "entity": "$.business_entity",
          579 "links": [
          580 {
          581 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          582 "rel": "upload",
          583 "method": "POST"
          584 }
          585 ]
          586 },
          587 {
          588 "id": "1c10c",
          589 "name": "BANK_STATEMENT",
          590 "entity": "$.business_entity",
          591 "links": [
          592 {
          593 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          594 "rel": "upload",
          595 "method": "POST"
          596 }
          597 ]
          598 },
          599 {
          600 "id": "2fbb0",
          601 "name": "CC_STATEMENT",
          602 "entity": "$.business_entity",
          603 "links": [
          604 {
          605 "href": "https://msmaster1int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/00ce6bff-5f4f-4eac-ae1f-7fc1b6ddc847/upload",
          606 "rel": "upload",
          607 "method": "POST"
          608 }
          609 ]
          610 }
          611 ]
          612 },
          613 "links": [
          614 {
          615 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/5J5BPEQEWPT9W",
          616 "rel": "self",
          617 "method": "GET"
          618 },
          619 {
          620 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/5J5BPEQEWPT9W",
          621 "rel": "edit",
          622 "method": "PATCH"
          623 },
          624 {
          625 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/5J5BPEQEWPT9W/wallet-domains?page=1",
          626 "rel": "wallet-domains",
          627 "method": "GET"
          628 }
          629 ]
          630}

          In this example, the merchant can transact for $5,000 more dollars or 30 more days, whichever comes first. When building your UI, show both values to the merchant.

          Sample response for account with $500,000 limit

            1{
            2 "account_id": "VS5LLPA9KC3JJ",
            3 "legal_country_code": "US",
            4 "individual_owners": [
            5 {
            6 "id": "VS5LLPA9KC3JJ",
            7 "names": [
            8 {
            9 "given_name": "Levin",
            10 "surname": "Huang",
            11 "id": "ZASLDNDUSPJUW",
            12 "type": "LEGAL"
            13 }
            14 ],
            15 "citizenship": "US",
            16 "primary_residence": {
            17 "address_line_1": "2211 N First St ",
            18 "address_line_2": "Unit 2000",
            19 "admin_area_2": "San Jose",
            20 "admin_area_1": "CA",
            21 "postal_code": "95134",
            22 "country_code": "US"
            23 },
            24 "phone_numbers": [
            25 {
            26 "country_code": "030",
            27 "national_number": "6151175",
            28 "id": "Q6K8CUKG5AKCG",
            29 "type": "MOBILE"
            30 }
            31 ],
            32 "birth_details": {
            33 "date_of_birth": "1995-08-01"
            34 },
            35 "identification_documents": [
            36 {
            37 "id": "22V4VGNN6FV8J",
            38 "identification_number": "****",
            39 "issuing_country_code": "US",
            40 "type": "SOCIAL_SECURITY_NUMBER"
            41 }
            42 ],
            43 "emails": [
            44 {
            45 "id": "XRVVHPAXETTKU",
            46 "email": "levin-personal-email@paypal.com"
            47 }
            48 ]
            49 }
            50 ],
            51 "business_entity": {
            52 "type": "CORPORATION",
            53 "merchant_category_code": "5933",
            54 "incorporation_details": {},
            55 "names": [
            56 {
            57 "business_name": "DECLINED",
            58 "id": "NKGTBF6QWGKLU",
            59 "type": "LEGAL"
            60 }
            61 ],
            62 "emails": [
            63 {
            64 "id": "L666EU4QXHPAS",
            65 "email": "levin-business-email@paypal.com"
            66 }
            67 ],
            68 "website_info": {
            69 "website_exists": true,
            70 "website_url": "https://developer.paypal.com/docs/multiparty/"
            71 },
            72 "registered_business_address": {
            73 "address_line_1": "2211 N First St ",
            74 "address_line_2": "Unit 1300",
            75 "admin_area_2": "San Jose",
            76 "admin_area_1": "CA",
            77 "postal_code": "95134",
            78 "country_code": "US"
            79 },
            80 "phone_numbers": [
            81 {
            82 "country_code": "1",
            83 "national_number": "06151188",
            84 "id": "A2EY3WUGCE2DW",
            85 "type": "BUSINESS"
            86 }
            87 ],
            88 "identification_documents": [
            89 {
            90 "id": "BW9AMRFZUHMXU",
            91 "identification_number": "****",
            92 "issuing_country_code": "US",
            93 "type": "EMPLOYER_IDENTIFICATION_NUMBER"
            94 }
            95 ],
            96 "beneficial_owners": {
            97 "individuals": [
            98 {
            99 "id": "P9MDPQCP6TUDN",
            100 "names": [
            101 {
            102 "given_name": "Lucas DECLINED",
            103 "surname": "Li DECLINED",
            104 "id": "B79ZVE39VHS4J",
            105 "type": "LEGAL"
            106 }
            107 ],
            108 "citizenship": "US",
            109 "addresses": [
            110 {
            111 "address_line_1": "2211 N First St ",
            112 "address_line_2": "Unit 2100",
            113 "admin_area_2": "San Jose",
            114 "admin_area_1": "CA",
            115 "postal_code": "95134",
            116 "country_code": "US",
            117 "id": "REQTZ5USBDBNL",
            118 "type": "HOME"
            119 }
            120 ],
            121 "phone_numbers": [
            122 {
            123 "country_code": "1",
            124 "national_number": "06151188",
            125 "id": "VF3RHVAG63YT8",
            126 "type": "WORK"
            127 }
            128 ],
            129 "birth_details": {
            130 "date_of_birth": "1990-01-01"
            131 },
            132 "identification_documents": [
            133 {
            134 "id": "BDM7J5T3SAV22",
            135 "identification_number": "****",
            136 "issuing_country_code": "US",
            137 "type": "SOCIAL_SECURITY_NUMBER"
            138 }
            139 ],
            140 "emails": [
            141 {
            142 "email": "lucas-personal-email@gmail.com"
            143 }
            144 ],
            145 "percentage_of_ownership": "30",
            146 "controlling_influence": false
            147 }
            148 ]
            149 },
            150 "office_bearers": [
            151 {
            152 "id": "FYQQRRY3GR2FN",
            153 "names": [
            154 {
            155 "given_name": "Alexei DECLINED",
            156 "surname": "Coreiba DECLINED",
            157 "id": "8XQN7DMTYSQD6",
            158 "type": "LEGAL"
            159 }
            160 ],
            161 "citizenship": "US",
            162 "addresses": [
            163 {
            164 "address_line_1": "2211 N First St ",
            165 "address_line_2": "Unit 2123",
            166 "admin_area_2": "San Jose",
            167 "admin_area_1": "CA",
            168 "postal_code": "95134",
            169 "country_code": "US",
            170 "id": "DEBZMB4JCJTJA",
            171 "type": "HOME"
            172 }
            173 ],
            174 "phone_numbers": [
            175 {
            176 "country_code": "1",
            177 "national_number": "06151188",
            178 "id": "PE4KEUCDNAPVL",
            179 "type": "WORK"
            180 }
            181 ],
            182 "birth_details": {
            183 "date_of_birth": "1990-01-01"
            184 },
            185 "identification_documents": [
            186 {
            187 "id": "WWLUUDEFNBBEC",
            188 "identification_number": "****",
            189 "issuing_country_code": "US",
            190 "type": "SOCIAL_SECURITY_NUMBER"
            191 }
            192 ],
            193 "emails": [
            194 {
            195 "email": "alexei-email@gmail.com"
            196 }
            197 ]
            198 }
            199 ],
            200 "declarations": [
            201 {
            202 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
            203 "value": "YES"
            204 }
            205 ]
            206 },
            207 "agreements": [
            208 {
            209 "type": "TERMS_ACCEPTED",
            210 "accepted_time": "2024-01-01T00:00:00Z"
            211 }
            212 ],
            213 "balances": [
            214 {
            215 "available_balances": [
            216 {
            217 "currency_code": "USD",
            218 "value": "0.00"
            219 }
            220 ],
            221 "available": {
            222 "currency_code": "USD",
            223 "value": "0.00"
            224 },
            225 "reserved": {
            226 "currency_code": "USD",
            227 "value": "0.00"
            228 }
            229 }
            230 ],
            231 "external_id": "EXT-1707165609",
            232 "organization": "us_org/net",
            233 "user_id": "1707165608814",
            234 "primary_currency_code": "USD",
            235 "soft_descriptor": "DECLINED",
            236 "capabilities": [
            237 {
            238 "name": "APPLE_PAY",
            239 "limits": [
            240 {
            241 "type": "AMOUNT",
            242 "unit": "USD",
            243 "value": "5000.00",
            244 "remaining_value": "5000.00",
            245 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            246 }
            247 ],
            248 "grace_periods": [
            249 {
            250 "start_time": "2024-02-05T20:40:37.110Z",
            251 "expiry_time": "2024-03-06T20:40:37.110Z"
            252 }
            253 ],
            254 "status": "ACTIVE"
            255 },
            256 {
            257 "name": "GOOGLE_PAY",
            258 "limits": [
            259 {
            260 "type": "AMOUNT",
            261 "unit": "USD",
            262 "value": "5000.00",
            263 "remaining_value": "5000.00",
            264 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            265 }
            266 ],
            267 "grace_periods": [
            268 {
            269 "start_time": "2024-02-05T20:40:37.110Z",
            270 "expiry_time": "2024-03-06T20:40:37.110Z"
            271 }
            272 ],
            273 "status": "ACTIVE"
            274 },
            275 {
            276 "name": "CUSTOM_CARD_PROCESSING",
            277 "limits": [
            278 {
            279 "type": "AMOUNT",
            280 "unit": "USD",
            281 "value": "5000.00",
            282 "remaining_value": "5000.00",
            283 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            284 }
            285 ],
            286 "grace_periods": [
            287 {
            288 "start_time": "2024-02-05T20:40:37.110Z",
            289 "expiry_time": "2024-03-06T20:40:37.110Z"
            290 }
            291 ],
            292 "status": "ACTIVE"
            293 },
            294 {
            295 "name": "RECEIVE_MONEY",
            296 "limits": [
            297 {
            298 "type": "AMOUNT",
            299 "unit": "USD",
            300 "value": "5000.00",
            301 "remaining_value": "5000.00",
            302 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            303 }
            304 ],
            305 "grace_periods": [
            306 {
            307 "start_time": "2024-02-05T20:40:37.110Z",
            308 "expiry_time": "2024-03-06T20:40:37.110Z"
            309 }
            310 ],
            311 "status": "ACTIVE"
            312 },
            313 {
            314 "name": "WITHDRAW_MONEY",
            315 "status": "NEED_DATA"
            316 }
            317 ],
            318 "process_view": {
            319 "processes": [
            320 {
            321 "name": "MANAGED_PATH_KYC_VERIFICATION",
            322 "status": "NEED_MORE_DATA",
            323 "capabilities": [
            324 {
            325 "name": "RECEIVE_MONEY",
            326 "limits": [
            327 {
            328 "type": "AMOUNT",
            329 "unit": "USD",
            330 "value": "5000.00",
            331 "remaining_value": "5000.00",
            332 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            333 }
            334 ],
            335 "grace_periods": [
            336 {
            337 "start_time": "2024-02-05T20:40:37.110Z",
            338 "expiry_time": "2024-03-06T20:40:37.110Z"
            339 }
            340 ]
            341 },
            342 {
            343 "name": "CUSTOM_CARD_PROCESSING",
            344 "limits": [
            345 {
            346 "type": "AMOUNT",
            347 "unit": "USD",
            348 "value": "5000.00",
            349 "remaining_value": "5000.00",
            350 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            351 }
            352 ],
            353 "grace_periods": [
            354 {
            355 "start_time": "2024-02-05T20:40:37.110Z",
            356 "expiry_time": "2024-03-06T20:40:37.110Z"
            357 }
            358 ]
            359 },
            360 {
            361 "name": "WITHDRAW_MONEY"
            362 },
            363 {
            364 "name": "GOOGLE_PAY",
            365 "limits": [
            366 {
            367 "type": "AMOUNT",
            368 "unit": "USD",
            369 "value": "5000.00",
            370 "remaining_value": "5000.00",
            371 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            372 }
            373 ],
            374 "grace_periods": [
            375 {
            376 "start_time": "2024-02-05T20:40:37.110Z",
            377 "expiry_time": "2024-03-06T20:40:37.110Z"
            378 }
            379 ]
            380 },
            381 {
            382 "name": "APPLE_PAY",
            383 "limits": [
            384 {
            385 "type": "AMOUNT",
            386 "unit": "USD",
            387 "value": "5000.00",
            388 "remaining_value": "5000.00",
            389 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            390 }
            391 ],
            392 "grace_periods": [
            393 {
            394 "start_time": "2024-02-05T20:40:37.110Z",
            395 "expiry_time": "2024-03-06T20:40:37.110Z"
            396 }
            397 ]
            398 }
            399 ],
            400 "required": {
            401 "op": "ALL_OF",
            402 "attributes": [
            403 {
            404 "op": "ONE_OF",
            405 "attributes": [
            406 "3559c",
            407 "cff47",
            408 "3af36",
            409 "81743",
            410 "42d50"
            411 ]
            412 },
            413 {
            414 "op": "ONE_OF",
            415 "attributes": [
            416 "e9366",
            417 "ec8c1",
            418 "c3612",
            419 "640b4"
            420 ]
            421 },
            422 "e1ee7"
            423 ]
            424 }
            425 },
            426 {
            427 "name": "MANAGED_PATH_BO_VERIFICATION",
            428 "status": "NEED_MORE_DATA",
            429 "capabilities": [
            430 {
            431 "name": "APPLE_PAY",
            432 "limits": [
            433 {
            434 "type": "AMOUNT",
            435 "unit": "USD",
            436 "value": "500000.00",
            437 "remaining_value": "500000.00",
            438 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            439 }
            440 ]
            441 },
            442 {
            443 "name": "CUSTOM_CARD_PROCESSING",
            444 "limits": [
            445 {
            446 "type": "AMOUNT",
            447 "unit": "USD",
            448 "value": "500000.00",
            449 "remaining_value": "500000.00",
            450 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            451 }
            452 ]
            453 },
            454 {
            455 "name": "RECEIVE_MONEY",
            456 "limits": [
            457 {
            458 "type": "AMOUNT",
            459 "unit": "USD",
            460 "value": "500000.00",
            461 "remaining_value": "500000.00",
            462 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            463 }
            464 ]
            465 },
            466 {
            467 "name": "GOOGLE_PAY",
            468 "limits": [
            469 {
            470 "type": "AMOUNT",
            471 "unit": "USD",
            472 "value": "500000.00",
            473 "remaining_value": "500000.00",
            474 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            475 }
            476 ]
            477 },
            478 {
            479 "name": "WITHDRAW_MONEY",
            480 "limits": [
            481 {
            482 "type": "AMOUNT",
            483 "unit": "USD",
            484 "value": "500000.00",
            485 "remaining_value": "500000.00",
            486 "implication_of_limit_breach": "BLOCK_CAPABILITY"
            487 }
            488 ]
            489 }
            490 ],
            491 "required": {
            492 "op": "ALL_OF",
            493 "attributes": [
            494 "cb54e",
            495 "a6185"
            496 ]
            497 }
            498 },
            499 {
            500 "name": "MANAGED_PATH_BO_COLLECTION",
            501 "status": "COMPLETED",
            502 "capabilities": [
            503 {
            504 "name": "CUSTOM_CARD_PROCESSING"
            505 },
            506 {
            507 "name": "RECEIVE_MONEY"
            508 },
            509 {
            510 "name": "APPLE_PAY"
            511 },
            512 {
            513 "name": "WITHDRAW_MONEY"
            514 },
            515 {
            516 "name": "GOOGLE_PAY"
            517 }
            518 ]
            519 },
            520 {
            521 "name": "MANAGED_PATH_KYC_COLLECTION",
            522 "status": "COMPLETED",
            523 "capabilities": [
            524 {
            525 "name": "APPLE_PAY"
            526 },
            527 {
            528 "name": "CUSTOM_CARD_PROCESSING"
            529 },
            530 {
            531 "name": "WITHDRAW_MONEY"
            532 },
            533 {
            534 "name": "GOOGLE_PAY"
            535 },
            536 {
            537 "name": "RECEIVE_MONEY"
            538 }
            539 ]
            540 }
            541 ],
            542 "required_documents": [
            543 {
            544 "id": "e1ee7",
            545 "name": "BUSINESS_EXISTENCE",
            546 "entity": "$.business_entity",
            547 "links": [
            548 {
            549 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            550 "rel": "upload",
            551 "method": "POST"
            552 }
            553 ]
            554 },
            555 {
            556 "id": "42d50",
            557 "name": "BUSINESS_LICENSE",
            558 "entity": "$.business_entity",
            559 "links": [
            560 {
            561 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            562 "rel": "upload",
            563 "method": "POST"
            564 }
            565 ]
            566 },
            567 {
            568 "id": "640b4",
            569 "name": "USIRS_EIN_ALLOCATION_LETTER",
            570 "entity": "$.business_entity",
            571 "links": [
            572 {
            573 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            574 "rel": "upload",
            575 "method": "POST"
            576 }
            577 ]
            578 },
            579 {
            580 "id": "c3612",
            581 "name": "BUSINESS_INCOME_TAX_RETURN",
            582 "entity": "$.business_entity",
            583 "links": [
            584 {
            585 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            586 "rel": "upload",
            587 "method": "POST"
            588 }
            589 ]
            590 },
            591 {
            592 "id": "3559c",
            593 "name": "TAX_ASSESSMENT_NOTICE",
            594 "entity": "$.business_entity",
            595 "links": [
            596 {
            597 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            598 "rel": "upload",
            599 "method": "POST"
            600 }
            601 ]
            602 },
            603 {
            604 "id": "cff47",
            605 "name": "UTILITIES_BILL",
            606 "entity": "$.business_entity",
            607 "links": [
            608 {
            609 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            610 "rel": "upload",
            611 "method": "POST"
            612 }
            613 ]
            614 },
            615 {
            616 "id": "e9366",
            617 "name": "USIRS_NAME_CHANGE_LETTER",
            618 "entity": "$.business_entity",
            619 "links": [
            620 {
            621 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            622 "rel": "upload",
            623 "method": "POST"
            624 }
            625 ]
            626 },
            627 {
            628 "id": "3af36",
            629 "name": "INSURANCE_STATEMENT",
            630 "entity": "$.business_entity",
            631 "links": [
            632 {
            633 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            634 "rel": "upload",
            635 "method": "POST"
            636 }
            637 ]
            638 },
            639 {
            640 "id": "ec8c1",
            641 "name": "BANK_STATEMENT",
            642 "entity": "$.business_entity",
            643 "links": [
            644 {
            645 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            646 "rel": "upload",
            647 "method": "POST"
            648 }
            649 ]
            650 },
            651 {
            652 "id": "a6185",
            653 "name": "SOCIAL_SECURITY_NUMBER",
            654 "entity": "$.business_entity.office_bearers[?(@['id']=='FYQQRRY3GR2FN')]",
            655 "links": [
            656 {
            657 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/54a907dc-66f7-424f-a568-a7aa9ef0af76/upload",
            658 "rel": "upload",
            659 "method": "POST"
            660 }
            661 ]
            662 },
            663 {
            664 "id": "81743",
            665 "name": "CC_STATEMENT",
            666 "entity": "$.business_entity",
            667 "links": [
            668 {
            669 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
            670 "rel": "upload",
            671 "method": "POST"
            672 }
            673 ]
            674 },
            675 {
            676 "id": "cb54e",
            677 "name": "SOCIAL_SECURITY_NUMBER",
            678 "entity": "$.business_entity.beneficial_owners.individuals[?(@['id']=='P9MDPQCP6TUDN')]",
            679 "links": [
            680 {
            681 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/eca7fa47-6c71-42c7-b044-4abd6ecc2ed4/upload",
            682 "rel": "upload",
            683 "method": "POST"
            684 }
            685 ]
            686 }
            687 ]
            688 },
            689 "links": [
            690 {
            691 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/VS5LLPA9KC3JJ",
            692 "rel": "self",
            693 "method": "GET"
            694 },
            695 {
            696 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/VS5LLPA9KC3JJ",
            697 "rel": "edit",
            698 "method": "PATCH"
            699 },
            700 {
            701 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/VS5LLPA9KC3JJ/wallet-domains?page=1",
            702 "rel": "wallet-domains",
            703 "method": "GET"
            704 }
            705 ]
            706}

            Limits in Europe and the UK

            Know Your Customer (KYC) and Beneficial Owner (BO) data collection and verification is mandatory in Europe and in the UK.

            Process name

            Name as it appears in the API

            Restriction

            KYC and Beneficial Owner Verification

            MANAGED_PATH_KYC

            PayPal limits the cumulative received amount to €1,000/£1,000 in transactions. PayPal blocks withdrawals and transactions after the amount reaches the limit.

            These limitations appear in the capabilities section of the response.

            Sample response for account with €1,000 limit

              1{
              2
              3 "account_id": "USZJERXL88TDL",
              4
              5 "legal_country_code": "FR",
              6
              7 "individual_owners": [
              8
              9 {
              10
              11 "id": "USZJERXL88TDL",
              12
              13 "names": [
              14
              15 {
              16
              17 "given_name": "Levin",
              18
              19 "surname": "Huang",
              20
              21 "id": "5YQX3KBKL7T4S",
              22
              23 "type": "LEGAL"
              24
              25 }
              26
              27 ],
              28
              29 "citizenship": "FR",
              30
              31 "primary_residence": {
              32
              33 "address_line_1": "24 rue du Faubourg Saint Honore",
              34
              35 "address_line_2": "Unit 2000",
              36
              37 "admin_area_2": "Paris",
              38
              39 "postal_code": "75008",
              40
              41 "country_code": "FR"
              42
              43 },
              44
              45 "phone_numbers": [
              46
              47 {
              48
              49 "country_code": "030",
              50
              51 "national_number": "6151175",
              52
              53 "id": "WNBMJ2MH49GV8",
              54
              55 "type": "MOBILE"
              56
              57 }
              58
              59 ],
              60
              61 "birth_details": {
              62
              63 "date_of_birth": "1995-08-01"
              64
              65 },
              66
              67 "identification_documents": [
              68
              69 {
              70
              71 "id": "XVZWDF8XJ4E56",
              72
              73 "identification_number": "****",
              74
              75 "issuing_country_code": "FR",
              76
              77 "type": "PASSPORT"
              78
              79 }
              80
              81 ],
              82
              83 "emails": [
              84
              85 {
              86
              87 "id": "ZGQNPZAHLT2M2",
              88
              89 "email": "levin-personal-email@paypal.com"
              90
              91 }
              92
              93 ]
              94
              95 }
              96
              97 ],
              98
              99 "business_entity": {
              100
              101 "type": "CORPORATION",
              102
              103 "merchant_category_code": "5933",
              104
              105 "incorporation_details": {
              106
              107 "incorporation_country_code": "FR",
              108
              109 "incorporation_date": "1999-01-10"
              110
              111 },
              112
              113 "names": [
              114
              115 {
              116
              117 "business_name": "Fintech Unicorn",
              118
              119 "id": "JYP26SH5ZMRS2",
              120
              121 "type": "LEGAL"
              122
              123 }
              124
              125 ],
              126
              127 "emails": [
              128
              129 {
              130
              131 "id": "EMHQK8MS2E5HL",
              132
              133 "email": "levin-business-email@paypal.com"
              134
              135 }
              136
              137 ],
              138
              139 "website": "https://developer.paypal.com/docs/multiparty/",
              140
              141 "registered_business_address": {
              142
              143 "address_line_1": "24 rue du Faubourg Saint Honore",
              144
              145 "address_line_2": "Unit 2100",
              146
              147 "admin_area_2": "Paris",
              148
              149 "postal_code": "75008",
              150
              151 "country_code": "FR"
              152
              153 },
              154
              155 "phone_numbers": [
              156
              157 {
              158
              159 "country_code": "1",
              160
              161 "national_number": "06151188",
              162
              163 "id": "PGYBZUPJAD6D2",
              164
              165 "type": "BUSINESS"
              166
              167 }
              168
              169 ],
              170
              171 "identification_documents": [
              172
              173 {
              174
              175 "id": "QHQ8W2T3DN4V2",
              176
              177 "identification_number": "****",
              178
              179 "issuing_country_code": "FR",
              180
              181 "type": "BUSINESS_REGISTRATION_NUMBER"
              182
              183 }
              184
              185 ],
              186
              187 "beneficial_owners": {
              188
              189 "individuals": [
              190
              191 {
              192
              193 "id": "UJGR6DTJH5QDS",
              194
              195 "names": [
              196
              197 {
              198
              199 "given_name": "Lucas",
              200
              201 "surname": "Li",
              202
              203 "id": "JP8BTRPBFJJSY",
              204
              205 "type": "LEGAL"
              206
              207 }
              208
              209 ],
              210
              211 "citizenship": "FR",
              212
              213 "addresses": [
              214
              215 {
              216
              217 "address_line_1": "24 rue du Faubourg Saint Honore",
              218
              219 "address_line_2": "Unit 2200",
              220
              221 "admin_area_2": "Paris",
              222
              223 "postal_code": "75008",
              224
              225 "country_code": "FR",
              226
              227 "id": "XHNHA4FR9EXZL",
              228
              229 "type": "HOME"
              230
              231 }
              232
              233 ],
              234
              235 "phone_numbers": [
              236
              237 {
              238
              239 "country_code": "1",
              240
              241 "national_number": "06151188",
              242
              243 "id": "DX29KCM3BQ88C",
              244
              245 "type": "WORK"
              246
              247 }
              248
              249 ],
              250
              251 "birth_details": {
              252
              253 "date_of_birth": "1990-01-01"
              254
              255 },
              256
              257 "identification_documents": [
              258
              259 {
              260
              261 "id": "U2TQ26HZQCDQG",
              262
              263 "identification_number": "****",
              264
              265 "issuing_country_code": "FR",
              266
              267 "type": "NATIONAL_ID_CARD"
              268
              269 }
              270
              271 ],
              272
              273 "emails": [
              274
              275 {
              276
              277 "email": "lucas-personal-email@gmail.com"
              278
              279 }
              280
              281 ],
              282
              283 "percentage_of_ownership": "30",
              284
              285 "controlling_influence": false
              286
              287 }
              288
              289 ]
              290
              291 },
              292
              293 "office_bearers": [
              294
              295 {
              296
              297 "id": "FDT34KT4KHJQG",
              298
              299 "names": [
              300
              301 {
              302
              303 "given_name": "Alexei",
              304
              305 "surname": "Coreiba",
              306
              307 "id": "TE9Z2AG96NSY6",
              308
              309 "type": "LEGAL"
              310
              311 }
              312
              313 ],
              314
              315 "citizenship": "FR",
              316
              317 "addresses": [
              318
              319 {
              320
              321 "address_line_1": "24 rue du Faubourg Saint Honore",
              322
              323 "address_line_2": "Unit 2300",
              324
              325 "admin_area_2": "Paris",
              326
              327 "postal_code": "75008",
              328
              329 "country_code": "FR",
              330
              331 "id": "VXL3PNNNS8566",
              332
              333 "type": "HOME"
              334
              335 }
              336
              337 ],
              338
              339 "phone_numbers": [
              340
              341 {
              342
              343 "country_code": "1",
              344
              345 "national_number": "06151188",
              346
              347 "id": "FVYF6MMJC2J58",
              348
              349 "type": "WORK"
              350
              351 }
              352
              353 ],
              354
              355 "birth_details": {
              356
              357 "date_of_birth": "1990-01-01"
              358
              359 },
              360
              361 "identification_documents": [
              362
              363 {
              364
              365 "id": "WL5V3MZ53KPDE",
              366
              367 "identification_number": "****",
              368
              369 "issuing_country_code": "FR",
              370
              371 "type": "PASSPORT"
              372
              373 }
              374
              375 ],
              376
              377 "emails": [
              378
              379 {
              380
              381 "email": "alexei-email@gmail.com"
              382
              383 }
              384
              385 ],
              386
              387 "role": "DIRECTOR"
              388
              389 }
              390
              391 ],
              392
              393 "declarations": [
              394
              395 {
              396
              397 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
              398
              399 "value": "YES"
              400
              401 }
              402
              403 ]
              404
              405 },
              406
              407 "agreements": [
              408
              409 {
              410
              411 "type": "TERMS_ACCEPTED",
              412
              413 "accepted_time": "2024-01-01T00:00:00Z"
              414
              415 }
              416
              417 ],
              418
              419 "balances": [
              420
              421 {
              422
              423 "available_balances": [
              424
              425 {
              426
              427 "currency_code": "EUR",
              428
              429 "value": "0.00"
              430
              431 }
              432
              433 ],
              434
              435 "available": {
              436
              437 "currency_code": "EUR",
              438
              439 "value": "0.00"
              440
              441 },
              442
              443 "reserved": {
              444
              445 "currency_code": "EUR",
              446
              447 "value": "0.00"
              448
              449 }
              450
              451 }
              452
              453 ],
              454
              455 "external_id": "EXT-1707163925",
              456
              457 "organization": "us_org/net",
              458
              459 "user_id": "1707163924527",
              460
              461 "primary_currency_code": "EUR",
              462
              463 "soft_descriptor": "FINTECHUNICORN",
              464
              465 "capabilities": [
              466
              467 {
              468
              469 "name": "APPLE_PAY",
              470
              471 "limits": [
              472
              473 {
              474
              475 "type": "AMOUNT",
              476
              477 "unit": "EUR",
              478
              479 "value": "1000.00",
              480
              481 "remaining_value": "1000.00",
              482
              483 "implication_of_limit_breach": "START_GRACE_PERIOD"
              484
              485 }
              486
              487 ],
              488
              489 "status": "ACTIVE"
              490
              491 },
              492
              493 {
              494
              495 "name": "GOOGLE_PAY",
              496
              497 "limits": [
              498
              499 {
              500
              501 "type": "AMOUNT",
              502
              503 "unit": "EUR",
              504
              505 "value": "1000.00",
              506
              507 "remaining_value": "1000.00",
              508
              509 "implication_of_limit_breach": "START_GRACE_PERIOD"
              510
              511 }
              512
              513 ],
              514
              515 "status": "ACTIVE"
              516
              517 },
              518
              519 {
              520
              521 "name": "CUSTOM_CARD_PROCESSING",
              522
              523 "limits": [
              524
              525 {
              526
              527 "type": "AMOUNT",
              528
              529 "unit": "EUR",
              530
              531 "value": "1000.00",
              532
              533 "remaining_value": "1000.00",
              534
              535 "implication_of_limit_breach": "START_GRACE_PERIOD"
              536
              537 }
              538
              539 ],
              540
              541 "status": "ACTIVE"
              542
              543 },
              544
              545 {
              546
              547 "name": "RECEIVE_MONEY",
              548
              549 "status": "ACTIVE"
              550
              551 },
              552
              553 {
              554
              555 "name": "WITHDRAW_MONEY",
              556
              557 "limits": [
              558
              559 {
              560
              561 "type": "AMOUNT",
              562
              563 "unit": "EUR",
              564
              565 "value": "1000.00",
              566
              567 "remaining_value": "1000.00",
              568
              569 "implication_of_limit_breach": "BLOCK_CAPABILITY"
              570
              571 }
              572
              573 ],
              574
              575 "status": "ACTIVE"
              576
              577 }
              578
              579 ],
              580
              581 "process_view": {
              582
              583 "processes": [
              584
              585 {
              586
              587 "name": "MANAGED_PATH_KYC",
              588
              589 "status": "NEED_MORE_DATA",
              590
              591 "capabilities": [
              592
              593 {
              594
              595 "name": "GOOGLE_PAY",
              596
              597 "limits": [
              598
              599 {
              600
              601 "type": "AMOUNT",
              602
              603 "unit": "EUR",
              604
              605 "value": "1000.00",
              606
              607 "remaining_value": "1000.00",
              608
              609 "implication_of_limit_breach": "START_GRACE_PERIOD"
              610
              611 }
              612
              613 ]
              614
              615 },
              616
              617 {
              618
              619 "name": "CUSTOM_CARD_PROCESSING",
              620
              621 "limits": [
              622
              623 {
              624
              625 "type": "AMOUNT",
              626
              627 "unit": "EUR",
              628
              629 "value": "1000.00",
              630
              631 "remaining_value": "1000.00",
              632
              633 "implication_of_limit_breach": "START_GRACE_PERIOD"
              634
              635 }
              636
              637 ]
              638
              639 },
              640
              641 {
              642
              643 "name": "APPLE_PAY",
              644
              645 "limits": [
              646
              647 {
              648
              649 "type": "AMOUNT",
              650
              651 "unit": "EUR",
              652
              653 "value": "1000.00",
              654
              655 "remaining_value": "1000.00",
              656
              657 "implication_of_limit_breach": "START_GRACE_PERIOD"
              658
              659 }
              660
              661 ]
              662
              663 },
              664
              665 {
              666
              667 "name": "WITHDRAW_MONEY",
              668
              669 "limits": [
              670
              671 {
              672
              673 "type": "AMOUNT",
              674
              675 "unit": "EUR",
              676
              677 "value": "1000.00",
              678
              679 "remaining_value": "1000.00",
              680
              681 "implication_of_limit_breach": "BLOCK_CAPABILITY"
              682
              683 }
              684
              685 ]
              686
              687 }
              688
              689 ],
              690
              691 "required_corrections": {
              692
              693 "op": "ALL_OF",
              694
              695 "attributes": [
              696
              697 "$.business_entity.type",
              698
              699 "$.business_entity.identification_documents[?(@['type']=='BUSINESS_REGISTRATION_NUMBER')]",
              700
              701 "$.business_entity.registered_business_address",
              702
              703 "$.business_entity.names[?(@['type']=='LEGAL')]"
              704
              705 ]
              706
              707 }
              708
              709 },
              710
              711 {
              712
              713 "name": "MANAGED_PATH_CIP_COLLECTION",
              714
              715 "status": "COMPLETED",
              716
              717 "capabilities": [
              718
              719 {
              720
              721 "name": "APPLE_PAY"
              722
              723 },
              724
              725 {
              726
              727 "name": "RECEIVE_MONEY"
              728
              729 },
              730
              731 {
              732
              733 "name": "GOOGLE_PAY"
              734
              735 },
              736
              737 {
              738
              739 "name": "CUSTOM_CARD_PROCESSING"
              740
              741 },
              742
              743 {
              744
              745 "name": "WITHDRAW_MONEY"
              746
              747 }
              748
              749 ]
              750
              751 }
              752
              753 ]
              754
              755 },
              756
              757 "links": [
              758
              759 {
              760
              761 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL",
              762
              763 "rel": "self",
              764
              765 "method": "GET"
              766
              767 },
              768
              769 {
              770
              771 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL",
              772
              773 "rel": "edit",
              774
              775 "method": "PATCH"
              776
              777 },
              778
              779 {
              780
              781 "href": "https://api.sandbox.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL/wallet-domains?page=1",
              782
              783 "rel": "wallet-domains",
              784
              785 "method": "GET"
              786
              787 }
              788
              789 ]
              790
              791}
              3

              Analyze process_view

              If the merchant does not pass the verification, use process_view to find the data elements the merchant should provide.

              Specify views="process_view"in the GET request, either in the HTTP header or as a URL query parameter, to view process_view in the response.

              To know more about process_view, see the Structure of process_view object section.

              Sample response: Information required for verification (US)

              The following example is a sample response when a merchant account verification needs additional information. The required object shows the data the merchant must provide to complete the verification.

                1{
                2 "account_id": "K9K6ERAVXB47C",
                3 "legal_country_code": "US",
                4 "individual_owners": [
                5 {
                6 "id": "K9K6ERAVXB47C",
                7 "names": [
                8 {
                9 "given_name": "Levin",
                10 "surname": "Huang",
                11 "id": "GR2DQSB8HCM86",
                12 "type": "LEGAL"
                13 }
                14 ],
                15 "citizenship": "US",
                16 "primary_residence": {
                17 "address_line_1": "2211 N First St ",
                18 "address_line_2": "Unit 2000",
                19 "admin_area_2": "San Jose",
                20 "admin_area_1": "CA",
                21 "postal_code": "95134",
                22 "country_code": "US"
                23 },
                24 "phone_numbers": [
                25 {
                26 "country_code": "030",
                27 "national_number": "6151175",
                28 "id": "57BHQSBN3FCSW",
                29 "type": "MOBILE"
                30 }
                31 ],
                32 "birth_details": {
                33 "date_of_birth": "1995-08-01"
                34 },
                35 "identification_documents": [
                36 {
                37 "id": "A5UKKQXTJRTLJ",
                38 "identification_number": "****",
                39 "issuing_country_code": "US",
                40 "type": "SOCIAL_SECURITY_NUMBER"
                41 }
                42 ],
                43 "emails": [
                44 {
                45 "id": "5DANXH62N7NNJ",
                46 "email": "levin-personal-email@paypal.com"
                47 }
                48 ]
                49 }
                50 ],
                51 "business_entity": {
                52 "type": "CORPORATION",
                53 "merchant_category_code": "5933",
                54 "incorporation_details": {},
                55 "names": [
                56 {
                57 "business_name": "Fintech Unicorn",
                58 "id": "YGPEJS55S7PCU",
                59 "type": "LEGAL"
                60 }
                61 ],
                62 "emails": [
                63 {
                64 "id": "22NKFTHAEA2L6",
                65 "email": "levin-business-email@paypal.com"
                66 }
                67 ],
                68 "website_info": {
                69 "website_exists": true,
                70 "website_url": "https://developer.paypal.com/docs/multiparty/"
                71 },
                72 "registered_business_address": {
                73 "address_line_1": "2211 N First St ",
                74 "address_line_2": "Unit 1300",
                75 "admin_area_2": "San Jose",
                76 "admin_area_1": "CA",
                77 "postal_code": "95134",
                78 "country_code": "US"
                79 },
                80 "phone_numbers": [
                81 {
                82 "country_code": "1",
                83 "national_number": "06151188",
                84 "id": "QDNNJ3LE83BV2",
                85 "type": "BUSINESS"
                86 }
                87 ],
                88 "identification_documents": [
                89 {
                90 "id": "LPNQUBZ8TV4FW",
                91 "identification_number": "****",
                92 "issuing_country_code": "US",
                93 "type": "EMPLOYER_IDENTIFICATION_NUMBER"
                94 }
                95 ],
                96 "declarations": [
                97 {
                98 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
                99 "value": "NO"
                100 }
                101 ]
                102 },
                103 "agreements": [
                104 {
                105 "type": "TERMS_ACCEPTED",
                106 "accepted_time": "2024-01-01T00:00:00Z"
                107 }
                108 ],
                109 "balances": [
                110 {
                111 "available_balances": [
                112 {
                113 "currency_code": "USD",
                114 "value": "0.00"
                115 }
                116 ],
                117 "available": {
                118 "currency_code": "USD",
                119 "value": "0.00"
                120 },
                121 "reserved": {
                122 "currency_code": "USD",
                123 "value": "0.00"
                124 }
                125 }
                126 ],
                127 "external_id": "EXT-1707166728",
                128 "organization": "us_org/net",
                129 "user_id": "1707166727984",
                130 "primary_currency_code": "USD",
                131 "soft_descriptor": "FINTECHUNIC",
                132 "capabilities": [
                133 {
                134 "name": "APPLE_PAY",
                135 "status": "NEED_DATA"
                136 },
                137 {
                138 "name": "GOOGLE_PAY",
                139 "status": "NEED_DATA"
                140 },
                141 {
                142 "name": "CUSTOM_CARD_PROCESSING",
                143 "status": "NEED_DATA"
                144 },
                145 {
                146 "name": "RECEIVE_MONEY",
                147 "status": "NEED_DATA"
                148 },
                149 {
                150 "name": "WITHDRAW_MONEY",
                151 "status": "NEED_DATA"
                152 }
                153 ],
                154
                155// process_view object
                156
                157 "process_view": {
                158 "processes": [
                159 {
                160 "name": "MANAGED_PATH_BO_COLLECTION",
                161 "status": "NEED_MORE_DATA",
                162 "capabilities": [
                163 {
                164 "name": "CUSTOM_CARD_PROCESSING"
                165 },
                166 {
                167 "name": "GOOGLE_PAY"
                168 },
                169 {
                170 "name": "WITHDRAW_MONEY"
                171 },
                172 {
                173 "name": "APPLE_PAY"
                174 },
                175 {
                176 "name": "RECEIVE_MONEY"
                177 }
                178 ],
                179 "required": {
                180 "op": "ALL_OF",
                181 "attributes": [
                182 "$.business_entity.office_bearers[*].citizenship",
                183 "$.business_entity.office_bearers[*].emails",
                184 "$.business_entity.office_bearers[*].names[?(@['type']=='LEGAL')]",
                185 "$.business_entity.office_bearers[*].birth_details.date_of_birth",
                186 "$.business_entity.office_bearers[*].addresses[?(@['type']=='HOME')]",
                187 "$.business_entity.office_bearers[*].phone_numbers[?(@['type']=='WORK')]"
                188 ]
                189 }
                190 },
                191 {
                192 "name": "MANAGED_PATH_BO_VERIFICATION",
                193 "status": "NEED_MORE_DATA",
                194 "capabilities": [
                195 {
                196 "name": "APPLE_PAY",
                197 "limits": [
                198 {
                199 "type": "AMOUNT",
                200 "unit": "USD",
                201 "value": "500000.00",
                202 "remaining_value": "500000.00",
                203 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                204 }
                205 ]
                206 },
                207 {
                208 "name": "RECEIVE_MONEY",
                209 "limits": [
                210 {
                211 "type": "AMOUNT",
                212 "unit": "USD",
                213 "value": "500000.00",
                214 "remaining_value": "500000.00",
                215 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                216 }
                217 ]
                218 },
                219 {
                220 "name": "GOOGLE_PAY",
                221 "limits": [
                222 {
                223 "type": "AMOUNT",
                224 "unit": "USD",
                225 "value": "500000.00",
                226 "remaining_value": "500000.00",
                227 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                228 }
                229 ]
                230 },
                231 {
                232 "name": "WITHDRAW_MONEY",
                233 "limits": [
                234 {
                235 "type": "AMOUNT",
                236 "unit": "USD",
                237 "value": "500000.00",
                238 "remaining_value": "500000.00",
                239 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                240 }
                241 ]
                242 },
                243 {
                244 "name": "CUSTOM_CARD_PROCESSING",
                245 "limits": [
                246 {
                247 "type": "AMOUNT",
                248 "unit": "USD",
                249 "value": "500000.00",
                250 "remaining_value": "500000.00",
                251 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                252 }
                253 ]
                254 }
                255 ],
                256 "required": {
                257 "op": "ALL_OF",
                258 "attributes": [
                259 "$.business_entity.office_bearers[*].citizenship"
                260 ]
                261 }
                262 },
                263 {
                264 "name": "MANAGED_PATH_KYC_VERIFICATION",
                265 "status": "COMPLETED",
                266 "capabilities": [
                267 {
                268 "name": "WITHDRAW_MONEY"
                269 },
                270 {
                271 "name": "GOOGLE_PAY"
                272 },
                273 {
                274 "name": "RECEIVE_MONEY"
                275 },
                276 {
                277 "name": "APPLE_PAY"
                278 },
                279 {
                280 "name": "CUSTOM_CARD_PROCESSING"
                281 }
                282 ]
                283 },
                284 {
                285 "name": "MANAGED_PATH_KYC_COLLECTION",
                286 "status": "COMPLETED",
                287 "capabilities": [
                288 {
                289 "name": "RECEIVE_MONEY"
                290 },
                291 {
                292 "name": "CUSTOM_CARD_PROCESSING"
                293 },
                294 {
                295 "name": "APPLE_PAY"
                296 },
                297 {
                298 "name": "WITHDRAW_MONEY"
                299 },
                300 {
                301 "name": "GOOGLE_PAY"
                302 }
                303 ]
                304 }
                305 ]
                306 },
                307 "links": [
                308 {
                309 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/K9K6ERAVXB47C",
                310 "rel": "self",
                311 "method": "GET"
                312 },
                313 {
                314 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/K9K6ERAVXB47C",
                315 "rel": "edit",
                316 "method": "PATCH"
                317 }
                318 ]
                319}

                Sample response: Information required for verification (EU)

                The following example is a sample response when a merchant account verification in the European Union needs more information. The required object shows the data the merchant must provide to complete the verification.

                  1{
                  2 "account_id": "23PC3HNADFP2J",
                  3 "legal_country_code": "FR",
                  4 "individual_owners": [
                  5 {
                  6 "id": "23PC3HNADFP2J",
                  7 "names": [
                  8 {
                  9 "given_name": "Levin",
                  10 "surname": "Huang",
                  11 "id": "HAKBCPJRUZEP2",
                  12 "type": "LEGAL"
                  13 }
                  14 ],
                  15 "citizenship": "FR",
                  16 "primary_residence": {
                  17 "address_line_1": "24 rue du Faubourg Saint Honore",
                  18 "address_line_2": "Unit 2000",
                  19 "admin_area_2": "Paris",
                  20 "postal_code": "75008",
                  21 "country_code": "FR"
                  22 },
                  23 "phone_numbers": [
                  24 {
                  25 "country_code": "030",
                  26 "national_number": "6151175",
                  27 "id": "VB4FDVSH3KHGS",
                  28 "type": "MOBILE"
                  29 }
                  30 ],
                  31 "birth_details": {
                  32 "date_of_birth": "1995-08-01"
                  33 },
                  34 "identification_documents": [
                  35 {
                  36 "id": "9BMVHX9HM5H3G",
                  37 "identification_number": "****",
                  38 "issuing_country_code": "FR",
                  39 "type": "PASSPORT"
                  40 }
                  41 ],
                  42 "emails": [
                  43 {
                  44 "id": "C6Z86SFR4Q75J",
                  45 "email": "levin-personal-email@paypal.com"
                  46 }
                  47 ]
                  48 }
                  49 ],
                  50 "business_entity": {
                  51 "type": "CORPORATION",
                  52 "merchant_category_code": "5933",
                  53 "incorporation_details": {
                  54 "incorporation_country_code": "FR",
                  55 "incorporation_date": "1999-01-10"
                  56 },
                  57 "names": [
                  58 {
                  59 "business_name": "FINTECH UNICORN",
                  60 "id": "5JD67U874KZJY",
                  61 "type": "LEGAL"
                  62 }
                  63 ],
                  64 "emails": [
                  65 {
                  66 "id": "U4WENYWD5X7PU",
                  67 "email": "levin-business-email@paypal.com"
                  68 }
                  69 ],
                  70 "website": "https://developer.paypal.com/docs/multiparty/",
                  71 "registered_business_address": {
                  72 "address_line_1": "24 rue du Faubourg Saint Honore",
                  73 "address_line_2": "Unit 2100",
                  74 "admin_area_2": "Paris",
                  75 "postal_code": "75008",
                  76 "country_code": "FR"
                  77 },
                  78 "phone_numbers": [
                  79 {
                  80 "country_code": "1",
                  81 "national_number": "06151188",
                  82 "id": "HQE3JWM26N8UU",
                  83 "type": "BUSINESS"
                  84 }
                  85 ],
                  86 "identification_documents": [
                  87 {
                  88 "id": "42HL7HRQHT2JL",
                  89 "identification_number": "****",
                  90 "issuing_country_code": "FR",
                  91 "type": "BUSINESS_REGISTRATION_NUMBER"
                  92 }
                  93 ],
                  94 "declarations": [
                  95 {
                  96 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
                  97 "value": "NO"
                  98 }
                  99 ]
                  100 },
                  101 "agreements": [
                  102 {
                  103 "type": "TERMS_ACCEPTED",
                  104 "accepted_time": "2024-01-01T00:00:00Z"
                  105 }
                  106 ],
                  107 "external_id": "EXT-1707167597",
                  108 "organization": "us_org/net",
                  109 "user_id": "1707167597387",
                  110 "primary_currency_code": "EUR",
                  111 "soft_descriptor": "FINTECHUNIC",
                  112 "capabilities": [
                  113 {
                  114 "name": "APPLE_PAY",
                  115 "limits": [
                  116 {
                  117 "type": "AMOUNT",
                  118 "unit": "EUR",
                  119 "value": "1000.00",
                  120 "remaining_value": "1000.00",
                  121 "implication_of_limit_breach": "START_GRACE_PERIOD"
                  122 }
                  123 ],
                  124 "status": "ACTIVE"
                  125 },
                  126 {
                  127 "name": "GOOGLE_PAY",
                  128 "limits": [
                  129 {
                  130 "type": "AMOUNT",
                  131 "unit": "EUR",
                  132 "value": "1000.00",
                  133 "remaining_value": "1000.00",
                  134 "implication_of_limit_breach": "START_GRACE_PERIOD"
                  135 }
                  136 ],
                  137 "status": "ACTIVE"
                  138 },
                  139 {
                  140 "name": "CUSTOM_CARD_PROCESSING",
                  141 "limits": [
                  142 {
                  143 "type": "AMOUNT",
                  144 "unit": "EUR",
                  145 "value": "1000.00",
                  146 "remaining_value": "1000.00",
                  147 "implication_of_limit_breach": "START_GRACE_PERIOD"
                  148 }
                  149 ],
                  150 "status": "ACTIVE"
                  151 },
                  152 {
                  153 "name": "RECEIVE_MONEY",
                  154 "status": "ACTIVE"
                  155 },
                  156 {
                  157 "name": "WITHDRAW_MONEY",
                  158 "limits": [
                  159 {
                  160 "type": "AMOUNT",
                  161 "unit": "EUR",
                  162 "value": "1000.00",
                  163 "remaining_value": "1000.00",
                  164 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                  165 }
                  166 ],
                  167 "status": "ACTIVE"
                  168 }
                  169 ],
                  170 "process_view": {
                  171 "processes": [
                  172 {
                  173 "name": "MANAGED_PATH_CIP_COLLECTION",
                  174 "status": "COMPLETED",
                  175 "capabilities": [
                  176 {
                  177 "name": "RECEIVE_MONEY"
                  178 },
                  179 {
                  180 "name": "WITHDRAW_MONEY"
                  181 },
                  182 {
                  183 "name": "GOOGLE_PAY"
                  184 },
                  185 {
                  186 "name": "APPLE_PAY"
                  187 },
                  188 {
                  189 "name": "CUSTOM_CARD_PROCESSING"
                  190 }
                  191 ]
                  192 },
                  193 {
                  194 "name": "MANAGED_PATH_KYC",
                  195 "status": "NEED_MORE_DATA",
                  196 "capabilities": [
                  197 {
                  198 "name": "WITHDRAW_MONEY",
                  199 "limits": [
                  200 {
                  201 "type": "AMOUNT",
                  202 "unit": "EUR",
                  203 "value": "1000.00",
                  204 "remaining_value": "1000.00",
                  205 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                  206 }
                  207 ]
                  208 },
                  209 {
                  210 "name": "CUSTOM_CARD_PROCESSING",
                  211 "limits": [
                  212 {
                  213 "type": "AMOUNT",
                  214 "unit": "EUR",
                  215 "value": "1000.00",
                  216 "remaining_value": "1000.00",
                  217 "implication_of_limit_breach": "START_GRACE_PERIOD"
                  218 }
                  219 ]
                  220 },
                  221 {
                  222 "name": "GOOGLE_PAY",
                  223 "limits": [
                  224 {
                  225 "type": "AMOUNT",
                  226 "unit": "EUR",
                  227 "value": "1000.00",
                  228 "remaining_value": "1000.00",
                  229 "implication_of_limit_breach": "START_GRACE_PERIOD"
                  230 }
                  231 ]
                  232 },
                  233 {
                  234 "name": "APPLE_PAY",
                  235 "limits": [
                  236 {
                  237 "type": "AMOUNT",
                  238 "unit": "EUR",
                  239 "value": "1000.00",
                  240 "remaining_value": "1000.00",
                  241 "implication_of_limit_breach": "START_GRACE_PERIOD"
                  242 }
                  243 ]
                  244 }
                  245 ],
                  246 "required": {
                  247 "op": "ALL_OF",
                  248 "attributes": [
                  249 {
                  250 "op": "ONE_OF",
                  251 "attributes": [
                  252 {
                  253 "op": "ALL_OF",
                  254 "attributes": [
                  255 "$.business_entity.office_bearers[?(@['role']=='CEO')].citizenship",
                  256 "$.business_entity.office_bearers[?(@['role']=='CEO')].names[?(@['type']=='LEGAL')]",
                  257 "$.business_entity.office_bearers[?(@['role']=='CEO')].birth_details.date_of_birth",
                  258 "$.business_entity.office_bearers[?(@['role']=='CEO')].addresses[?(@['type']=='HOME')]"
                  259 ]
                  260 },
                  261 {
                  262 "op": "ALL_OF",
                  263 "attributes": [
                  264 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].citizenship",
                  265 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].names[?(@['type']=='LEGAL')]",
                  266 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].birth_details.date_of_birth",
                  267 "$.business_entity.office_bearers[?(@['role']=='TREASURER')].addresses[?(@['type']=='HOME')]"
                  268 ]
                  269 },
                  270 {
                  271 "op": "ALL_OF",
                  272 "attributes": [
                  273 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].citizenship",
                  274 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].names[?(@['type']=='LEGAL')]",
                  275 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].birth_details.date_of_birth",
                  276 "$.business_entity.office_bearers[?(@['role']=='CHAIRMAN')].addresses[?(@['type']=='HOME')]"
                  277 ]
                  278 },
                  279 {
                  280 "op": "ALL_OF",
                  281 "attributes": [
                  282 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].citizenship",
                  283 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].names[?(@['type']=='LEGAL')]",
                  284 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].birth_details.date_of_birth",
                  285 "$.business_entity.office_bearers[?(@['role']=='SECRETARY')].addresses[?(@['type']=='HOME')]"
                  286 ]
                  287 },
                  288 {
                  289 "op": "ALL_OF",
                  290 "attributes": [
                  291 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].citizenship",
                  292 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].percentage_of_ownership",
                  293 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].names[?(@['type']=='LEGAL')]",
                  294 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].birth_details.date_of_birth",
                  295 "$.business_entity.beneficial_owners.individuals[?(@['percentage_of_ownership']>=0.0)].addresses[?(@['type']=='HOME')]"
                  296 ]
                  297 },
                  298 {
                  299 "op": "ALL_OF",
                  300 "attributes": [
                  301 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].citizenship",
                  302 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].names[?(@['type']=='LEGAL')]",
                  303 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].birth_details.date_of_birth",
                  304 "$.business_entity.office_bearers[?(@['role']=='TRUSTEE')].addresses[?(@['type']=='HOME')]"
                  305 ]
                  306 }
                  307 ]
                  308 },
                  309 "$.business_entity.office_bearers[?(@['role']=='DIRECTOR')].citizenship",
                  310 "$.business_entity.office_bearers[?(@['role']=='DIRECTOR')].names[?(@['type']=='LEGAL')]",
                  311 "$.business_entity.office_bearers[?(@['role']=='DIRECTOR')].birth_details.date_of_birth"
                  312 ]
                  313 }
                  314 }
                  315 ]
                  316 },
                  317 "links": [
                  318 {
                  319 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/23PC3HNADFP2J",
                  320 "rel": "self",
                  321 "method": "GET"
                  322 },
                  323 {
                  324 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/23PC3HNADFP2J",
                  325 "rel": "edit",
                  326 "method": "PATCH"
                  327 }
                  328 ]
                  329}

                  Sample response: Information needs correction (EU)

                  If the verification process finds any incorrect information, the process_view object includes required_corrections that list the fields needing correction. This status also indicates that at least one attempt at electronic verification has failed, and the merchant must attempt electronic verification at least one more time.

                    1{
                    2 "account_id": "USZJERXL88TDL",
                    3 "legal_country_code": "FR",
                    4 "individual_owners": [
                    5 {
                    6 "id": "USZJERXL88TDL",
                    7 "names": [
                    8 {
                    9 "given_name": "Levin",
                    10 "surname": "Huang",
                    11 "id": "5YQX3KBKL7T4S",
                    12 "type": "LEGAL"
                    13 }
                    14 ],
                    15 "citizenship": "FR",
                    16 "primary_residence": {
                    17 "address_line_1": "24 rue du Faubourg Saint Honore",
                    18 "address_line_2": "Unit 2000",
                    19 "admin_area_2": "Paris",
                    20 "postal_code": "75008",
                    21 "country_code": "FR"
                    22 },
                    23 "phone_numbers": [
                    24 {
                    25 "country_code": "030",
                    26 "national_number": "6151175",
                    27 "id": "WNBMJ2MH49GV8",
                    28 "type": "MOBILE"
                    29 }
                    30 ],
                    31 "birth_details": {
                    32 "date_of_birth": "1995-08-01"
                    33 },
                    34 "identification_documents": [
                    35 {
                    36 "id": "XVZWDF8XJ4E56",
                    37 "identification_number": "****",
                    38 "issuing_country_code": "FR",
                    39 "type": "PASSPORT"
                    40 }
                    41 ],
                    42 "emails": [
                    43 {
                    44 "id": "ZGQNPZAHLT2M2",
                    45 "email": "levin-personal-email@paypal.com"
                    46 }
                    47 ]
                    48 }
                    49 ],
                    50 "business_entity": {
                    51 "type": "CORPORATION",
                    52 "merchant_category_code": "5933",
                    53 "incorporation_details": {
                    54 "incorporation_country_code": "FR",
                    55 "incorporation_date": "1999-01-10"
                    56 },
                    57 "names": [
                    58 {
                    59 "business_name": "Fintech Unicorn",
                    60 "id": "JYP26SH5ZMRS2",
                    61 "type": "LEGAL"
                    62 }
                    63 ],
                    64 "emails": [
                    65 {
                    66 "id": "EMHQK8MS2E5HL",
                    67 "email": "levin-business-email@paypal.com"
                    68 }
                    69 ],
                    70 "website": "https://developer.paypal.com/docs/multiparty/",
                    71 "registered_business_address": {
                    72 "address_line_1": "24 rue du Faubourg Saint Honore",
                    73 "address_line_2": "Unit 2100",
                    74 "admin_area_2": "Paris",
                    75 "postal_code": "75008",
                    76 "country_code": "FR"
                    77 },
                    78 "phone_numbers": [
                    79 {
                    80 "country_code": "1",
                    81 "national_number": "06151188",
                    82 "id": "PGYBZUPJAD6D2",
                    83 "type": "BUSINESS"
                    84 }
                    85 ],
                    86 "identification_documents": [
                    87 {
                    88 "id": "QHQ8W2T3DN4V2",
                    89 "identification_number": "****",
                    90 "issuing_country_code": "FR",
                    91 "type": "BUSINESS_REGISTRATION_NUMBER"
                    92 }
                    93 ],
                    94 "beneficial_owners": {
                    95 "individuals": [
                    96 {
                    97 "id": "UJGR6DTJH5QDS",
                    98 "names": [
                    99 {
                    100 "given_name": "Lucas",
                    101 "surname": "Li",
                    102 "id": "JP8BTRPBFJJSY",
                    103 "type": "LEGAL"
                    104 }
                    105 ],
                    106 "citizenship": "FR",
                    107 "addresses": [
                    108 {
                    109 "address_line_1": "24 rue du Faubourg Saint Honore",
                    110 "address_line_2": "Unit 2200",
                    111 "admin_area_2": "Paris",
                    112 "postal_code": "75008",
                    113 "country_code": "FR",
                    114 "id": "XHNHA4FR9EXZL",
                    115 "type": "HOME"
                    116 }
                    117 ],
                    118 "phone_numbers": [
                    119 {
                    120 "country_code": "1",
                    121 "national_number": "06151188",
                    122 "id": "DX29KCM3BQ88C",
                    123 "type": "WORK"
                    124 }
                    125 ],
                    126 "birth_details": {
                    127 "date_of_birth": "1990-01-01"
                    128 },
                    129 "identification_documents": [
                    130 {
                    131 "id": "U2TQ26HZQCDQG",
                    132 "identification_number": "****",
                    133 "issuing_country_code": "FR",
                    134 "type": "NATIONAL_ID_CARD"
                    135 }
                    136 ],
                    137 "emails": [
                    138 {
                    139 "email": "lucas-personal-email@gmail.com"
                    140 }
                    141 ],
                    142 "percentage_of_ownership": "30",
                    143 "controlling_influence": false
                    144 }
                    145 ]
                    146 },
                    147 "office_bearers": [
                    148 {
                    149 "id": "FDT34KT4KHJQG",
                    150 "names": [
                    151 {
                    152 "given_name": "Alexei",
                    153 "surname": "Coreiba",
                    154 "id": "TE9Z2AG96NSY6",
                    155 "type": "LEGAL"
                    156 }
                    157 ],
                    158 "citizenship": "FR",
                    159 "addresses": [
                    160 {
                    161 "address_line_1": "24 rue du Faubourg Saint Honore",
                    162 "address_line_2": "Unit 2300",
                    163 "admin_area_2": "Paris",
                    164 "postal_code": "75008",
                    165 "country_code": "FR",
                    166 "id": "VXL3PNNNS8566",
                    167 "type": "HOME"
                    168 }
                    169 ],
                    170 "phone_numbers": [
                    171 {
                    172 "country_code": "1",
                    173 "national_number": "06151188",
                    174 "id": "FVYF6MMJC2J58",
                    175 "type": "WORK"
                    176 }
                    177 ],
                    178 "birth_details": {
                    179 "date_of_birth": "1990-01-01"
                    180 },
                    181 "identification_documents": [
                    182 {
                    183 "id": "WL5V3MZ53KPDE",
                    184 "identification_number": "****",
                    185 "issuing_country_code": "FR",
                    186 "type": "PASSPORT"
                    187 }
                    188 ],
                    189 "emails": [
                    190 {
                    191 "email": "alexei-email@gmail.com"
                    192 }
                    193 ],
                    194 "role": "DIRECTOR"
                    195 }
                    196 ],
                    197 "declarations": [
                    198 {
                    199 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
                    200 "value": "YES"
                    201 }
                    202 ]
                    203 },
                    204 "agreements": [
                    205 {
                    206 "type": "TERMS_ACCEPTED",
                    207 "accepted_time": "2024-01-01T00:00:00Z"
                    208 }
                    209 ],
                    210 "balances": [
                    211 {
                    212 "available_balances": [
                    213 {
                    214 "currency_code": "EUR",
                    215 "value": "0.00"
                    216 }
                    217 ],
                    218 "available": {
                    219 "currency_code": "EUR",
                    220 "value": "0.00"
                    221 },
                    222 "reserved": {
                    223 "currency_code": "EUR",
                    224 "value": "0.00"
                    225 }
                    226 }
                    227 ],
                    228 "external_id": "EXT-1707163925",
                    229 "organization": "us_org/net",
                    230 "user_id": "1707163924527",
                    231 "primary_currency_code": "EUR",
                    232 "soft_descriptor": "FINTECHUNICORN",
                    233 "capabilities": [
                    234 {
                    235 "name": "APPLE_PAY",
                    236 "limits": [
                    237 {
                    238 "type": "AMOUNT",
                    239 "unit": "EUR",
                    240 "value": "1000.00",
                    241 "remaining_value": "1000.00",
                    242 "implication_of_limit_breach": "START_GRACE_PERIOD"
                    243 }
                    244 ],
                    245 "status": "ACTIVE"
                    246 },
                    247 {
                    248 "name": "GOOGLE_PAY",
                    249 "limits": [
                    250 {
                    251 "type": "AMOUNT",
                    252 "unit": "EUR",
                    253 "value": "1000.00",
                    254 "remaining_value": "1000.00",
                    255 "implication_of_limit_breach": "START_GRACE_PERIOD"
                    256 }
                    257 ],
                    258 "status": "ACTIVE"
                    259 },
                    260 {
                    261 "name": "CUSTOM_CARD_PROCESSING",
                    262 "limits": [
                    263 {
                    264 "type": "AMOUNT",
                    265 "unit": "EUR",
                    266 "value": "1000.00",
                    267 "remaining_value": "1000.00",
                    268 "implication_of_limit_breach": "START_GRACE_PERIOD"
                    269 }
                    270 ],
                    271 "status": "ACTIVE"
                    272 },
                    273 {
                    274 "name": "RECEIVE_MONEY",
                    275 "status": "ACTIVE"
                    276 },
                    277 {
                    278 "name": "WITHDRAW_MONEY",
                    279 "limits": [
                    280 {
                    281 "type": "AMOUNT",
                    282 "unit": "EUR",
                    283 "value": "1000.00",
                    284 "remaining_value": "1000.00",
                    285 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                    286 }
                    287 ],
                    288 "status": "ACTIVE"
                    289 }
                    290 ],
                    291 "process_view": {
                    292 "processes": [
                    293 {
                    294 "name": "MANAGED_PATH_KYC",
                    295 "status": "NEED_MORE_DATA",
                    296 "capabilities": [
                    297 {
                    298 "name": "GOOGLE_PAY",
                    299 "limits": [
                    300 {
                    301 "type": "AMOUNT",
                    302 "unit": "EUR",
                    303 "value": "1000.00",
                    304 "remaining_value": "1000.00",
                    305 "implication_of_limit_breach": "START_GRACE_PERIOD"
                    306 }
                    307 ]
                    308 },
                    309 {
                    310 "name": "CUSTOM_CARD_PROCESSING",
                    311 "limits": [
                    312 {
                    313 "type": "AMOUNT",
                    314 "unit": "EUR",
                    315 "value": "1000.00",
                    316 "remaining_value": "1000.00",
                    317 "implication_of_limit_breach": "START_GRACE_PERIOD"
                    318 }
                    319 ]
                    320 },
                    321 {
                    322 "name": "APPLE_PAY",
                    323 "limits": [
                    324 {
                    325 "type": "AMOUNT",
                    326 "unit": "EUR",
                    327 "value": "1000.00",
                    328 "remaining_value": "1000.00",
                    329 "implication_of_limit_breach": "START_GRACE_PERIOD"
                    330 }
                    331 ]
                    332 },
                    333 {
                    334 "name": "WITHDRAW_MONEY",
                    335 "limits": [
                    336 {
                    337 "type": "AMOUNT",
                    338 "unit": "EUR",
                    339 "value": "1000.00",
                    340 "remaining_value": "1000.00",
                    341 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                    342 }
                    343 ]
                    344 }
                    345 ],
                    346 "required_corrections": {
                    347 "op": "ALL_OF",
                    348 "attributes": [
                    349 "$.business_entity.type",
                    350 "$.business_entity.identification_documents[?(@['type']=='BUSINESS_REGISTRATION_NUMBER')]",
                    351 "$.business_entity.registered_business_address",
                    352 "$.business_entity.names[?(@['type']=='LEGAL')]"
                    353 ]
                    354 }
                    355 },
                    356 {
                    357 "name": "MANAGED_PATH_CIP_COLLECTION",
                    358 "status": "COMPLETED",
                    359 "capabilities": [
                    360 {
                    361 "name": "APPLE_PAY"
                    362 },
                    363 {
                    364 "name": "RECEIVE_MONEY"
                    365 },
                    366 {
                    367 "name": "GOOGLE_PAY"
                    368 },
                    369 {
                    370 "name": "CUSTOM_CARD_PROCESSING"
                    371 },
                    372 {
                    373 "name": "WITHDRAW_MONEY"
                    374 }
                    375 ]
                    376 }
                    377 ]
                    378 },
                    379 "links": [
                    380 {
                    381 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL",
                    382 "rel": "self",
                    383 "method": "GET"
                    384 },
                    385 {
                    386 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL",
                    387 "rel": "edit",
                    388 "method": "PATCH"
                    389 },
                    390 {
                    391 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/USZJERXL88TDL/wallet-domains?page=1",
                    392 "rel": "wallet-domains",
                    393 "method": "GET"
                    394 }
                    395 ]
                    396}

                    Sample response: Documents required for verification (US)

                    The following example is a sample response of a merchant account in the US that must provide documents to complete verification.The required_documentation object shows the documents the merchant must provide.

                      1{
                      2 "account_id": "VS5LLPA9KC3JJ",
                      3 "legal_country_code": "US",
                      4 "individual_owners": [
                      5 {
                      6 "id": "VS5LLPA9KC3JJ",
                      7 "names": [
                      8 {
                      9 "given_name": "Levin",
                      10 "surname": "Huang",
                      11 "id": "ZASLDNDUSPJUW",
                      12 "type": "LEGAL"
                      13 }
                      14 ],
                      15 "citizenship": "US",
                      16 "primary_residence": {
                      17 "address_line_1": "2211 N First St ",
                      18 "address_line_2": "Unit 2000",
                      19 "admin_area_2": "San Jose",
                      20 "admin_area_1": "CA",
                      21 "postal_code": "95134",
                      22 "country_code": "US"
                      23 },
                      24 "phone_numbers": [
                      25 {
                      26 "country_code": "030",
                      27 "national_number": "6151175",
                      28 "id": "Q6K8CUKG5AKCG",
                      29 "type": "MOBILE"
                      30 }
                      31 ],
                      32 "birth_details": {
                      33 "date_of_birth": "1995-08-01"
                      34 },
                      35 "identification_documents": [
                      36 {
                      37 "id": "22V4VGNN6FV8J",
                      38 "identification_number": "****",
                      39 "issuing_country_code": "US",
                      40 "type": "SOCIAL_SECURITY_NUMBER"
                      41 }
                      42 ],
                      43 "emails": [
                      44 {
                      45 "id": "XRVVHPAXETTKU",
                      46 "email": "levin-personal-email@paypal.com"
                      47 }
                      48 ]
                      49 }
                      50 ],
                      51 "business_entity": {
                      52 "type": "CORPORATION",
                      53 "merchant_category_code": "5933",
                      54 "incorporation_details": {},
                      55 "names": [
                      56 {
                      57 "business_name": "DECLINED",
                      58 "id": "NKGTBF6QWGKLU",
                      59 "type": "LEGAL"
                      60 }
                      61 ],
                      62 "emails": [
                      63 {
                      64 "id": "L666EU4QXHPAS",
                      65 "email": "levin-business-email@paypal.com"
                      66 }
                      67 ],
                      68 "website_info": {
                      69 "website_exists": true,
                      70 "website_url": "https://developer.paypal.com/docs/multiparty/"
                      71 },
                      72 "registered_business_address": {
                      73 "address_line_1": "2211 N First St ",
                      74 "address_line_2": "Unit 1300",
                      75 "admin_area_2": "San Jose",
                      76 "admin_area_1": "CA",
                      77 "postal_code": "95134",
                      78 "country_code": "US"
                      79 },
                      80 "phone_numbers": [
                      81 {
                      82 "country_code": "1",
                      83 "national_number": "06151188",
                      84 "id": "A2EY3WUGCE2DW",
                      85 "type": "BUSINESS"
                      86 }
                      87 ],
                      88 "identification_documents": [
                      89 {
                      90 "id": "BW9AMRFZUHMXU",
                      91 "identification_number": "****",
                      92 "issuing_country_code": "US",
                      93 "type": "EMPLOYER_IDENTIFICATION_NUMBER"
                      94 }
                      95 ],
                      96 "beneficial_owners": {
                      97 "individuals": [
                      98 {
                      99 "id": "P9MDPQCP6TUDN",
                      100 "names": [
                      101 {
                      102 "given_name": "Lucas DECLINED",
                      103 "surname": "Li DECLINED",
                      104 "id": "B79ZVE39VHS4J",
                      105 "type": "LEGAL"
                      106 }
                      107 ],
                      108 "citizenship": "US",
                      109 "addresses": [
                      110 {
                      111 "address_line_1": "2211 N First St ",
                      112 "address_line_2": "Unit 2100",
                      113 "admin_area_2": "San Jose",
                      114 "admin_area_1": "CA",
                      115 "postal_code": "95134",
                      116 "country_code": "US",
                      117 "id": "REQTZ5USBDBNL",
                      118 "type": "HOME"
                      119 }
                      120 ],
                      121 "phone_numbers": [
                      122 {
                      123 "country_code": "1",
                      124 "national_number": "06151188",
                      125 "id": "VF3RHVAG63YT8",
                      126 "type": "WORK"
                      127 }
                      128 ],
                      129 "birth_details": {
                      130 "date_of_birth": "1990-01-01"
                      131 },
                      132 "identification_documents": [
                      133 {
                      134 "id": "BDM7J5T3SAV22",
                      135 "identification_number": "****",
                      136 "issuing_country_code": "US",
                      137 "type": "SOCIAL_SECURITY_NUMBER"
                      138 }
                      139 ],
                      140 "emails": [
                      141 {
                      142 "email": "lucas-personal-email@gmail.com"
                      143 }
                      144 ],
                      145 "percentage_of_ownership": "30",
                      146 "controlling_influence": false
                      147 }
                      148 ]
                      149 },
                      150 "office_bearers": [
                      151 {
                      152 "id": "FYQQRRY3GR2FN",
                      153 "names": [
                      154 {
                      155 "given_name": "Alexei DECLINED",
                      156 "surname": "Coreiba DECLINED",
                      157 "id": "8XQN7DMTYSQD6",
                      158 "type": "LEGAL"
                      159 }
                      160 ],
                      161 "citizenship": "US",
                      162 "addresses": [
                      163 {
                      164 "address_line_1": "2211 N First St ",
                      165 "address_line_2": "Unit 2123",
                      166 "admin_area_2": "San Jose",
                      167 "admin_area_1": "CA",
                      168 "postal_code": "95134",
                      169 "country_code": "US",
                      170 "id": "DEBZMB4JCJTJA",
                      171 "type": "HOME"
                      172 }
                      173 ],
                      174 "phone_numbers": [
                      175 {
                      176 "country_code": "1",
                      177 "national_number": "06151188",
                      178 "id": "PE4KEUCDNAPVL",
                      179 "type": "WORK"
                      180 }
                      181 ],
                      182 "birth_details": {
                      183 "date_of_birth": "1990-01-01"
                      184 },
                      185 "identification_documents": [
                      186 {
                      187 "id": "WWLUUDEFNBBEC",
                      188 "identification_number": "****",
                      189 "issuing_country_code": "US",
                      190 "type": "SOCIAL_SECURITY_NUMBER"
                      191 }
                      192 ],
                      193 "emails": [
                      194 {
                      195 "email": "alexei-email@gmail.com"
                      196 }
                      197 ]
                      198 }
                      199 ],
                      200 "declarations": [
                      201 {
                      202 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
                      203 "value": "YES"
                      204 }
                      205 ]
                      206 },
                      207 "agreements": [
                      208 {
                      209 "type": "TERMS_ACCEPTED",
                      210 "accepted_time": "2024-01-01T00:00:00Z"
                      211 }
                      212 ],
                      213 "balances": [
                      214 {
                      215 "available_balances": [
                      216 {
                      217 "currency_code": "USD",
                      218 "value": "0.00"
                      219 }
                      220 ],
                      221 "available": {
                      222 "currency_code": "USD",
                      223 "value": "0.00"
                      224 },
                      225 "reserved": {
                      226 "currency_code": "USD",
                      227 "value": "0.00"
                      228 }
                      229 }
                      230 ],
                      231 "external_id": "EXT-1707165609",
                      232 "organization": "us_org/net",
                      233 "user_id": "1707165608814",
                      234 "primary_currency_code": "USD",
                      235 "soft_descriptor": "DECLINED",
                      236 "capabilities": [
                      237 {
                      238 "name": "APPLE_PAY",
                      239 "limits": [
                      240 {
                      241 "type": "AMOUNT",
                      242 "unit": "USD",
                      243 "value": "5000.00",
                      244 "remaining_value": "5000.00",
                      245 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      246 }
                      247 ],
                      248 "grace_periods": [
                      249 {
                      250 "start_time": "2024-02-05T20:40:37.110Z",
                      251 "expiry_time": "2024-03-06T20:40:37.110Z"
                      252 }
                      253 ],
                      254 "status": "ACTIVE"
                      255 },
                      256 {
                      257 "name": "GOOGLE_PAY",
                      258 "limits": [
                      259 {
                      260 "type": "AMOUNT",
                      261 "unit": "USD",
                      262 "value": "5000.00",
                      263 "remaining_value": "5000.00",
                      264 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      265 }
                      266 ],
                      267 "grace_periods": [
                      268 {
                      269 "start_time": "2024-02-05T20:40:37.110Z",
                      270 "expiry_time": "2024-03-06T20:40:37.110Z"
                      271 }
                      272 ],
                      273 "status": "ACTIVE"
                      274 },
                      275 {
                      276 "name": "CUSTOM_CARD_PROCESSING",
                      277 "limits": [
                      278 {
                      279 "type": "AMOUNT",
                      280 "unit": "USD",
                      281 "value": "5000.00",
                      282 "remaining_value": "5000.00",
                      283 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      284 }
                      285 ],
                      286 "grace_periods": [
                      287 {
                      288 "start_time": "2024-02-05T20:40:37.110Z",
                      289 "expiry_time": "2024-03-06T20:40:37.110Z"
                      290 }
                      291 ],
                      292 "status": "ACTIVE"
                      293 },
                      294 {
                      295 "name": "RECEIVE_MONEY",
                      296 "limits": [
                      297 {
                      298 "type": "AMOUNT",
                      299 "unit": "USD",
                      300 "value": "5000.00",
                      301 "remaining_value": "5000.00",
                      302 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      303 }
                      304 ],
                      305 "grace_periods": [
                      306 {
                      307 "start_time": "2024-02-05T20:40:37.110Z",
                      308 "expiry_time": "2024-03-06T20:40:37.110Z"
                      309 }
                      310 ],
                      311 "status": "ACTIVE"
                      312 },
                      313 {
                      314 "name": "WITHDRAW_MONEY",
                      315 "status": "NEED_DATA"
                      316 }
                      317 ],
                      318 "process_view": {
                      319 "processes": [
                      320 {
                      321 "name": "MANAGED_PATH_KYC_VERIFICATION",
                      322 "status": "NEED_MORE_DATA",
                      323 "capabilities": [
                      324 {
                      325 "name": "RECEIVE_MONEY",
                      326 "limits": [
                      327 {
                      328 "type": "AMOUNT",
                      329 "unit": "USD",
                      330 "value": "5000.00",
                      331 "remaining_value": "5000.00",
                      332 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      333 }
                      334 ],
                      335 "grace_periods": [
                      336 {
                      337 "start_time": "2024-02-05T20:40:37.110Z",
                      338 "expiry_time": "2024-03-06T20:40:37.110Z"
                      339 }
                      340 ]
                      341 },
                      342 {
                      343 "name": "CUSTOM_CARD_PROCESSING",
                      344 "limits": [
                      345 {
                      346 "type": "AMOUNT",
                      347 "unit": "USD",
                      348 "value": "5000.00",
                      349 "remaining_value": "5000.00",
                      350 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      351 }
                      352 ],
                      353 "grace_periods": [
                      354 {
                      355 "start_time": "2024-02-05T20:40:37.110Z",
                      356 "expiry_time": "2024-03-06T20:40:37.110Z"
                      357 }
                      358 ]
                      359 },
                      360 {
                      361 "name": "WITHDRAW_MONEY"
                      362 },
                      363 {
                      364 "name": "GOOGLE_PAY",
                      365 "limits": [
                      366 {
                      367 "type": "AMOUNT",
                      368 "unit": "USD",
                      369 "value": "5000.00",
                      370 "remaining_value": "5000.00",
                      371 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      372 }
                      373 ],
                      374 "grace_periods": [
                      375 {
                      376 "start_time": "2024-02-05T20:40:37.110Z",
                      377 "expiry_time": "2024-03-06T20:40:37.110Z"
                      378 }
                      379 ]
                      380 },
                      381 {
                      382 "name": "APPLE_PAY",
                      383 "limits": [
                      384 {
                      385 "type": "AMOUNT",
                      386 "unit": "USD",
                      387 "value": "5000.00",
                      388 "remaining_value": "5000.00",
                      389 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      390 }
                      391 ],
                      392 "grace_periods": [
                      393 {
                      394 "start_time": "2024-02-05T20:40:37.110Z",
                      395 "expiry_time": "2024-03-06T20:40:37.110Z"
                      396 }
                      397 ]
                      398 }
                      399 ],
                      400 "required": {
                      401 "op": "ALL_OF",
                      402 "attributes": [
                      403 {
                      404 "op": "ONE_OF",
                      405 "attributes": [
                      406 "3559c",
                      407 "cff47",
                      408 "3af36",
                      409 "81743",
                      410 "42d50"
                      411 ]
                      412 },
                      413 {
                      414 "op": "ONE_OF",
                      415 "attributes": [
                      416 "e9366",
                      417 "ec8c1",
                      418 "c3612",
                      419 "640b4"
                      420 ]
                      421 },
                      422 "e1ee7"
                      423 ]
                      424 }
                      425 },
                      426 {
                      427 "name": "MANAGED_PATH_BO_VERIFICATION",
                      428 "status": "NEED_MORE_DATA",
                      429 "capabilities": [
                      430 {
                      431 "name": "APPLE_PAY",
                      432 "limits": [
                      433 {
                      434 "type": "AMOUNT",
                      435 "unit": "USD",
                      436 "value": "500000.00",
                      437 "remaining_value": "500000.00",
                      438 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      439 }
                      440 ]
                      441 },
                      442 {
                      443 "name": "CUSTOM_CARD_PROCESSING",
                      444 "limits": [
                      445 {
                      446 "type": "AMOUNT",
                      447 "unit": "USD",
                      448 "value": "500000.00",
                      449 "remaining_value": "500000.00",
                      450 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      451 }
                      452 ]
                      453 },
                      454 {
                      455 "name": "RECEIVE_MONEY",
                      456 "limits": [
                      457 {
                      458 "type": "AMOUNT",
                      459 "unit": "USD",
                      460 "value": "500000.00",
                      461 "remaining_value": "500000.00",
                      462 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      463 }
                      464 ]
                      465 },
                      466 {
                      467 "name": "GOOGLE_PAY",
                      468 "limits": [
                      469 {
                      470 "type": "AMOUNT",
                      471 "unit": "USD",
                      472 "value": "500000.00",
                      473 "remaining_value": "500000.00",
                      474 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      475 }
                      476 ]
                      477 },
                      478 {
                      479 "name": "WITHDRAW_MONEY",
                      480 "limits": [
                      481 {
                      482 "type": "AMOUNT",
                      483 "unit": "USD",
                      484 "value": "500000.00",
                      485 "remaining_value": "500000.00",
                      486 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                      487 }
                      488 ]
                      489 }
                      490 ],
                      491 "required": {
                      492 "op": "ALL_OF",
                      493 "attributes": [
                      494 "cb54e",
                      495 "a6185"
                      496 ]
                      497 }
                      498 },
                      499 {
                      500 "name": "MANAGED_PATH_BO_COLLECTION",
                      501 "status": "COMPLETED",
                      502 "capabilities": [
                      503 {
                      504 "name": "CUSTOM_CARD_PROCESSING"
                      505 },
                      506 {
                      507 "name": "RECEIVE_MONEY"
                      508 },
                      509 {
                      510 "name": "APPLE_PAY"
                      511 },
                      512 {
                      513 "name": "WITHDRAW_MONEY"
                      514 },
                      515 {
                      516 "name": "GOOGLE_PAY"
                      517 }
                      518 ]
                      519 },
                      520 {
                      521 "name": "MANAGED_PATH_KYC_COLLECTION",
                      522 "status": "COMPLETED",
                      523 "capabilities": [
                      524 {
                      525 "name": "APPLE_PAY"
                      526 },
                      527 {
                      528 "name": "CUSTOM_CARD_PROCESSING"
                      529 },
                      530 {
                      531 "name": "WITHDRAW_MONEY"
                      532 },
                      533 {
                      534 "name": "GOOGLE_PAY"
                      535 },
                      536 {
                      537 "name": "RECEIVE_MONEY"
                      538 }
                      539 ]
                      540 }
                      541 ],
                      542 "required_documents": [
                      543 {
                      544 "id": "e1ee7",
                      545 "name": "BUSINESS_EXISTENCE",
                      546 "entity": "$.business_entity",
                      547 "links": [
                      548 {
                      549 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      550 "rel": "upload",
                      551 "method": "POST"
                      552 }
                      553 ]
                      554 },
                      555 {
                      556 "id": "42d50",
                      557 "name": "BUSINESS_LICENSE",
                      558 "entity": "$.business_entity",
                      559 "links": [
                      560 {
                      561 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      562 "rel": "upload",
                      563 "method": "POST"
                      564 }
                      565 ]
                      566 },
                      567 {
                      568 "id": "640b4",
                      569 "name": "USIRS_EIN_ALLOCATION_LETTER",
                      570 "entity": "$.business_entity",
                      571 "links": [
                      572 {
                      573 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      574 "rel": "upload",
                      575 "method": "POST"
                      576 }
                      577 ]
                      578 },
                      579 {
                      580 "id": "c3612",
                      581 "name": "BUSINESS_INCOME_TAX_RETURN",
                      582 "entity": "$.business_entity",
                      583 "links": [
                      584 {
                      585 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      586 "rel": "upload",
                      587 "method": "POST"
                      588 }
                      589 ]
                      590 },
                      591 {
                      592 "id": "3559c",
                      593 "name": "TAX_ASSESSMENT_NOTICE",
                      594 "entity": "$.business_entity",
                      595 "links": [
                      596 {
                      597 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      598 "rel": "upload",
                      599 "method": "POST"
                      600 }
                      601 ]
                      602 },
                      603 {
                      604 "id": "cff47",
                      605 "name": "UTILITIES_BILL",
                      606 "entity": "$.business_entity",
                      607 "links": [
                      608 {
                      609 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      610 "rel": "upload",
                      611 "method": "POST"
                      612 }
                      613 ]
                      614 },
                      615 {
                      616 "id": "e9366",
                      617 "name": "USIRS_NAME_CHANGE_LETTER",
                      618 "entity": "$.business_entity",
                      619 "links": [
                      620 {
                      621 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      622 "rel": "upload",
                      623 "method": "POST"
                      624 }
                      625 ]
                      626 },
                      627 {
                      628 "id": "3af36",
                      629 "name": "INSURANCE_STATEMENT",
                      630 "entity": "$.business_entity",
                      631 "links": [
                      632 {
                      633 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      634 "rel": "upload",
                      635 "method": "POST"
                      636 }
                      637 ]
                      638 },
                      639 {
                      640 "id": "ec8c1",
                      641 "name": "BANK_STATEMENT",
                      642 "entity": "$.business_entity",
                      643 "links": [
                      644 {
                      645 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      646 "rel": "upload",
                      647 "method": "POST"
                      648 }
                      649 ]
                      650 },
                      651 {
                      652 "id": "a6185",
                      653 "name": "SOCIAL_SECURITY_NUMBER",
                      654 "entity": "$.business_entity.office_bearers[?(@['id']=='FYQQRRY3GR2FN')]",
                      655 "links": [
                      656 {
                      657 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/54a907dc-66f7-424f-a568-a7aa9ef0af76/upload",
                      658 "rel": "upload",
                      659 "method": "POST"
                      660 }
                      661 ]
                      662 },
                      663 {
                      664 "id": "81743",
                      665 "name": "CC_STATEMENT",
                      666 "entity": "$.business_entity",
                      667 "links": [
                      668 {
                      669 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/877a54da-823e-4a7a-a92b-aa49bd7644ef/upload",
                      670 "rel": "upload",
                      671 "method": "POST"
                      672 }
                      673 ]
                      674 },
                      675 {
                      676 "id": "cb54e",
                      677 "name": "SOCIAL_SECURITY_NUMBER",
                      678 "entity": "$.business_entity.beneficial_owners.individuals[?(@['id']=='P9MDPQCP6TUDN')]",
                      679 "links": [
                      680 {
                      681 "href": "https://msmaster2int.g.devqa.gcp.dev.paypalinc.com:17707/v1/customer/supporting-documents/eca7fa47-6c71-42c7-b044-4abd6ecc2ed4/upload",
                      682 "rel": "upload",
                      683 "method": "POST"
                      684 }
                      685 ]
                      686 }
                      687 ]
                      688 },
                      689 "links": [
                      690 {
                      691 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/VS5LLPA9KC3JJ",
                      692 "rel": "self",
                      693 "method": "GET"
                      694 },
                      695 {
                      696 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/VS5LLPA9KC3JJ",
                      697 "rel": "edit",
                      698 "method": "PATCH"
                      699 },
                      700 {
                      701 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/VS5LLPA9KC3JJ/wallet-domains?page=1",
                      702 "rel": "wallet-domains",
                      703 "method": "GET"
                      704 }
                      705 ]
                      706}

                      Sample response: Documents required for verification (EU)

                      The following example is a sample response of a merchant account in the EU that must provide documents to complete verification.The required_documentation object shows the documents the merchant must provide.

                        1{
                        2 "account_id": "7WXK6WF4DNRNL",
                        3 "legal_country_code": "FR",
                        4 "individual_owners": [
                        5 {
                        6 "id": "7WXK6WF4DNRNL",
                        7 "names": [
                        8 {
                        9 "given_name": "Levin",
                        10 "surname": "Huang",
                        11 "id": "PVR7JFU79TX32",
                        12 "type": "LEGAL"
                        13 }
                        14 ],
                        15 "citizenship": "FR",
                        16 "primary_residence": {
                        17 "address_line_1": "24 rue du Faubourg Saint Honore",
                        18 "address_line_2": "Unit 2000",
                        19 "admin_area_2": "Paris",
                        20 "postal_code": "75008",
                        21 "country_code": "FR"
                        22 },
                        23 "phone_numbers": [
                        24 {
                        25 "country_code": "030",
                        26 "national_number": "6151175",
                        27 "id": "PJ7YTK9M6VPUA",
                        28 "type": "MOBILE"
                        29 }
                        30 ],
                        31 "birth_details": {
                        32 "date_of_birth": "1995-08-01"
                        33 },
                        34 "identification_documents": [
                        35 {
                        36 "id": "APYHBDZ7EYNWS",
                        37 "identification_number": "****",
                        38 "issuing_country_code": "FR",
                        39 "type": "PASSPORT"
                        40 }
                        41 ],
                        42 "emails": [
                        43 {
                        44 "id": "JQ9YXZCW8X8TY",
                        45 "email": "levin-personal-email@paypal.com"
                        46 }
                        47 ]
                        48 }
                        49 ],
                        50 "business_entity": {
                        51 "type": "CORPORATION",
                        52 "merchant_category_code": "5933",
                        53 "incorporation_details": {
                        54 "incorporation_country_code": "FR",
                        55 "incorporation_date": "1999-01-10"
                        56 },
                        57 "names": [
                        58 {
                        59 "business_name": "Fintech Unicorn",
                        60 "id": "D6JJSUB939N6Q",
                        61 "type": "LEGAL"
                        62 }
                        63 ],
                        64 "emails": [
                        65 {
                        66 "id": "M7NGL85UT44FU",
                        67 "email": "levin-business-email@paypal.com"
                        68 }
                        69 ],
                        70 "website": "https://developer.paypal.com/docs/multiparty/",
                        71 "registered_business_address": {
                        72 "address_line_1": "24 rue du Faubourg Saint Honore",
                        73 "address_line_2": "Unit 2100",
                        74 "admin_area_2": "Paris",
                        75 "postal_code": "75008",
                        76 "country_code": "FR"
                        77 },
                        78 "phone_numbers": [
                        79 {
                        80 "country_code": "1",
                        81 "national_number": "06151188",
                        82 "id": "F29KVBFZURDJ4",
                        83 "type": "BUSINESS"
                        84 }
                        85 ],
                        86 "identification_documents": [
                        87 {
                        88 "id": "4BQ7MT7TTGGRA",
                        89 "identification_number": "****",
                        90 "issuing_country_code": "FR",
                        91 "type": "BUSINESS_REGISTRATION_NUMBER"
                        92 }
                        93 ],
                        94 "beneficial_owners": {
                        95 "individuals": [
                        96 {
                        97 "id": "RT7ZHJNF57SAY",
                        98 "names": [
                        99 {
                        100 "given_name": "Lucas",
                        101 "surname": "Li",
                        102 "id": "4GXU9SQJ48ZZY",
                        103 "type": "LEGAL"
                        104 }
                        105 ],
                        106 "citizenship": "FR",
                        107 "addresses": [
                        108 {
                        109 "address_line_1": "24 rue du Faubourg Saint Honore",
                        110 "address_line_2": "Unit 2200",
                        111 "admin_area_2": "Paris",
                        112 "postal_code": "75008",
                        113 "country_code": "FR",
                        114 "id": "W6SMBMJ4RU456",
                        115 "type": "HOME"
                        116 }
                        117 ],
                        118 "phone_numbers": [
                        119 {
                        120 "country_code": "1",
                        121 "national_number": "06151188",
                        122 "id": "JUH9F7HCFYRB4",
                        123 "type": "WORK"
                        124 }
                        125 ],
                        126 "birth_details": {
                        127 "date_of_birth": "1990-01-01"
                        128 },
                        129 "identification_documents": [
                        130 {
                        131 "id": "6J2S8GKA7MGBQ",
                        132 "identification_number": "****",
                        133 "issuing_country_code": "FR",
                        134 "type": "NATIONAL_ID_CARD"
                        135 }
                        136 ],
                        137 "emails": [
                        138 {
                        139 "email": "lucas-personal-email@gmail.com"
                        140 }
                        141 ],
                        142 "percentage_of_ownership": "30",
                        143 "controlling_influence": false
                        144 }
                        145 ]
                        146 },
                        147 "office_bearers": [
                        148 {
                        149 "id": "LFEYBEJU6YSGQ",
                        150 "names": [
                        151 {
                        152 "given_name": "Alexei",
                        153 "surname": "Coreiba",
                        154 "id": "SWEV79M85SNDY",
                        155 "type": "LEGAL"
                        156 }
                        157 ],
                        158 "citizenship": "FR",
                        159 "addresses": [
                        160 {
                        161 "address_line_1": "24 rue du Faubourg Saint Honore",
                        162 "address_line_2": "Unit 2300",
                        163 "admin_area_2": "Paris",
                        164 "postal_code": "75008",
                        165 "country_code": "FR",
                        166 "id": "PN33HA8Z8WGQN",
                        167 "type": "HOME"
                        168 }
                        169 ],
                        170 "phone_numbers": [
                        171 {
                        172 "country_code": "1",
                        173 "national_number": "06151188",
                        174 "id": "NJXT9VBANW8CJ",
                        175 "type": "WORK"
                        176 }
                        177 ],
                        178 "birth_details": {
                        179 "date_of_birth": "1990-01-01"
                        180 },
                        181 "identification_documents": [
                        182 {
                        183 "id": "YNKN2979NELN2",
                        184 "identification_number": "****",
                        185 "issuing_country_code": "FR",
                        186 "type": "PASSPORT"
                        187 }
                        188 ],
                        189 "emails": [
                        190 {
                        191 "email": "alexei-email@gmail.com"
                        192 }
                        193 ],
                        194 "role": "DIRECTOR"
                        195 }
                        196 ],
                        197 "declarations": [
                        198 {
                        199 "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
                        200 "value": "YES"
                        201 }
                        202 ]
                        203 },
                        204 "agreements": [
                        205 {
                        206 "type": "TERMS_ACCEPTED",
                        207 "accepted_time": "2024-01-01T00:00:00Z"
                        208 }
                        209 ],
                        210 "balances": [
                        211 {
                        212 "available_balances": [
                        213 {
                        214 "currency_code": "EUR",
                        215 "value": "0.00"
                        216 }
                        217 ],
                        218 "available": {
                        219 "currency_code": "EUR",
                        220 "value": "0.00"
                        221 },
                        222 "reserved": {
                        223 "currency_code": "EUR",
                        224 "value": "0.00"
                        225 }
                        226 }
                        227 ],
                        228 "external_id": "EXT-1707165724",
                        229 "organization": "us_org/net",
                        230 "user_id": "1707165723575",
                        231 "primary_currency_code": "EUR",
                        232 "soft_descriptor": "FINTECHUNICORN",
                        233 "capabilities": [
                        234 {
                        235 "name": "APPLE_PAY",
                        236 "limits": [
                        237 {
                        238 "type": "AMOUNT",
                        239 "unit": "EUR",
                        240 "value": "1000.00",
                        241 "remaining_value": "1000.00",
                        242 "implication_of_limit_breach": "START_GRACE_PERIOD"
                        243 }
                        244 ],
                        245 "status": "ACTIVE"
                        246 },
                        247 {
                        248 "name": "GOOGLE_PAY",
                        249 "limits": [
                        250 {
                        251 "type": "AMOUNT",
                        252 "unit": "EUR",
                        253 "value": "1000.00",
                        254 "remaining_value": "1000.00",
                        255 "implication_of_limit_breach": "START_GRACE_PERIOD"
                        256 }
                        257 ],
                        258 "status": "ACTIVE"
                        259 },
                        260 {
                        261 "name": "CUSTOM_CARD_PROCESSING",
                        262 "limits": [
                        263 {
                        264 "type": "AMOUNT",
                        265 "unit": "EUR",
                        266 "value": "1000.00",
                        267 "remaining_value": "1000.00",
                        268 "implication_of_limit_breach": "START_GRACE_PERIOD"
                        269 }
                        270 ],
                        271 "status": "ACTIVE"
                        272 },
                        273 {
                        274 "name": "RECEIVE_MONEY",
                        275 "status": "ACTIVE"
                        276 },
                        277 {
                        278 "name": "WITHDRAW_MONEY",
                        279 "limits": [
                        280 {
                        281 "type": "AMOUNT",
                        282 "unit": "EUR",
                        283 "value": "1000.00",
                        284 "remaining_value": "1000.00",
                        285 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                        286 }
                        287 ],
                        288 "status": "ACTIVE"
                        289 }
                        290 ],
                        291 "process_view": {
                        292 "processes": [
                        293 {
                        294 "name": "MANAGED_PATH_CIP_COLLECTION",
                        295 "status": "COMPLETED",
                        296 "capabilities": [
                        297 {
                        298 "name": "RECEIVE_MONEY"
                        299 },
                        300 {
                        301 "name": "APPLE_PAY"
                        302 },
                        303 {
                        304 "name": "CUSTOM_CARD_PROCESSING"
                        305 },
                        306 {
                        307 "name": "WITHDRAW_MONEY"
                        308 },
                        309 {
                        310 "name": "GOOGLE_PAY"
                        311 }
                        312 ]
                        313 },
                        314 {
                        315 "name": "MANAGED_PATH_KYC",
                        316 "status": "NEED_MORE_DATA",
                        317 "capabilities": [
                        318 {
                        319 "name": "GOOGLE_PAY",
                        320 "limits": [
                        321 {
                        322 "type": "AMOUNT",
                        323 "unit": "EUR",
                        324 "value": "1000.00",
                        325 "remaining_value": "1000.00",
                        326 "implication_of_limit_breach": "START_GRACE_PERIOD"
                        327 }
                        328 ]
                        329 },
                        330 {
                        331 "name": "CUSTOM_CARD_PROCESSING",
                        332 "limits": [
                        333 {
                        334 "type": "AMOUNT",
                        335 "unit": "EUR",
                        336 "value": "1000.00",
                        337 "remaining_value": "1000.00",
                        338 "implication_of_limit_breach": "START_GRACE_PERIOD"
                        339 }
                        340 ]
                        341 },
                        342 {
                        343 "name": "WITHDRAW_MONEY",
                        344 "limits": [
                        345 {
                        346 "type": "AMOUNT",
                        347 "unit": "EUR",
                        348 "value": "1000.00",
                        349 "remaining_value": "1000.00",
                        350 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                        351 }
                        352 ]
                        353 },
                        354 {
                        355 "name": "APPLE_PAY",
                        356 "limits": [
                        357 {
                        358 "type": "AMOUNT",
                        359 "unit": "EUR",
                        360 "value": "1000.00",
                        361 "remaining_value": "1000.00",
                        362 "implication_of_limit_breach": "START_GRACE_PERIOD"
                        363 }
                        364 ]
                        365 }
                        366 ],
                        367 "required": {
                        368 "op": "ALL_OF",
                        369 "attributes": [
                        370 "0c3a6",
                        371 {
                        372 "op": "ONE_OF",
                        373 "attributes": [
                        374 "b9293",
                        375 "2dfa6",
                        376 "88d7d",
                        377 "9ffb6"
                        378 ]
                        379 }
                        380 ]
                        381 },
                        382 "required_corrections": {
                        383 "op": "ALL_OF",
                        384 "attributes": [
                        385 {
                        386 "op": "ONE_OF",
                        387 "attributes": [
                        388 "b9293",
                        389 "2dfa6",
                        390 "88d7d",
                        391 "9ffb6"
                        392 ]
                        393 },
                        394 "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')].citizenship",
                        395 "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')].names[?(@['type']=='LEGAL')]",
                        396 "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')].birth_details.date_of_birth",
                        397 "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')].addresses[?(@['type']=='HOME')]",
                        398 "$.business_entity.type",
                        399 "$.business_entity.identification_documents[?(@['type']=='BUSINESS_REGISTRATION_NUMBER')]",
                        400 "$.business_entity.registered_business_address",
                        401 "0c3a6",
                        402 "$.business_entity.names[?(@['type']=='LEGAL')]"
                        403 ]
                        404 }
                        405 }
                        406 ],
                        407 "required_documents": [
                        408 {
                        409 "id": "88d7d",
                        410 "name": "PROOF_OF_IDENTITY",
                        411 "entity": "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')]",
                        412 "links": [
                        413 {
                        414 "href": "https://msmaster2intdev51.dev51.cbf.dev.paypalinc.com:17707/v1/customer/supporting-documents/37d7258d-a4fe-41e5-a145-c8ba93dcb481/upload",
                        415 "rel": "upload",
                        416 "method": "POST"
                        417 }
                        418 ]
                        419 },
                        420 {
                        421 "id": "b9293",
                        422 "name": "PASSPORT",
                        423 "entity": "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')]",
                        424 "links": [
                        425 {
                        426 "href": "https://msmaster2intdev51.dev51.cbf.dev.paypalinc.com:17707/v1/customer/supporting-documents/37d7258d-a4fe-41e5-a145-c8ba93dcb481/upload",
                        427 "rel": "upload",
                        428 "method": "POST"
                        429 }
                        430 ]
                        431 },
                        432 {
                        433 "id": "9ffb6",
                        434 "name": "NATIONAL_ID_CARD",
                        435 "entity": "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')]",
                        436 "links": [
                        437 {
                        438 "href": "https://msmaster2intdev51.dev51.cbf.dev.paypalinc.com:17707/v1/customer/supporting-documents/37d7258d-a4fe-41e5-a145-c8ba93dcb481/upload",
                        439 "rel": "upload",
                        440 "method": "POST"
                        441 }
                        442 ]
                        443 },
                        444 {
                        445 "id": "2dfa6",
                        446 "name": "DRIVERS_LICENSE",
                        447 "entity": "$.business_entity.beneficial_owners.individuals[?(@['id']=='RT7ZHJNF57SAY')]",
                        448 "links": [
                        449 {
                        450 "href": "https://msmaster2intdev51.dev51.cbf.dev.paypalinc.com:17707/v1/customer/supporting-documents/37d7258d-a4fe-41e5-a145-c8ba93dcb481/upload",
                        451 "rel": "upload",
                        452 "method": "POST"
                        453 }
                        454 ]
                        455 },
                        456 {
                        457 "id": "0c3a6",
                        458 "name": "BUSINESS_REGISTRATION",
                        459 "entity": "$.business_entity",
                        460 "links": [
                        461 {
                        462 "href": "https://msmaster2intdev51.dev51.cbf.dev.paypalinc.com:17707/v1/customer/supporting-documents/41d08d5d-5803-4d38-8934-d7fb866046f4/upload",
                        463 "rel": "upload",
                        464 "method": "POST"
                        465 }
                        466 ]
                        467 }
                        468 ]
                        469 },
                        470 "links": [
                        471 {
                        472 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/7WXK6WF4DNRNL",
                        473 "rel": "self",
                        474 "method": "GET"
                        475 },
                        476 {
                        477 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/7WXK6WF4DNRNL",
                        478 "rel": "edit",
                        479 "method": "PATCH"
                        480 },
                        481 {
                        482 "href": "https://msmaster.qa.paypal.com/v3/customer/managed-accounts/7WXK6WF4DNRNL/wallet-domains?page=1",
                        483 "rel": "wallet-domains",
                        484 "method": "GET"
                        485 }
                        486 ]
                        487}

                        Electronic verification attempts by country

                        The number of data validation attempts for each non-loginable merchant account varies by country.

                        Country

                        Number of attempts

                        US

                        1

                        FR

                        2

                        EU

                        2

                        CA

                        2

                        AU

                        2

                        UK

                        2

                        For example, in the US, you can only attempt electronic verifications once at account creation. In France, however, you must try electronic verification a second time after creating the account. If you don't want to retry electronic verification and want to ask merchants for documents immediately, resubmit the same data set again.

                        4

                        Start manual verification

                        After gathering the required information from your merchants, use the PATCH /v3/customer/managed-accounts/{id} endpoint or the POST /v1/customer/supporting-documents/{doc-id} endpoint to send the information to PayPal.

                        Depending on the type of update you need to complete, follow these options:

                        Use PATCH to add information

                        Use the PATCH method to add missing data to the merchant account.

                        The following example shows how to add an SSN to a merchant account in the United States.

                          1curl --location --request PATCH 'https://<Host>/v3/customer/managed-accounts/<Account-ID>’
                          2
                          3{
                          4 "op": "add",
                          5 "path": "/attributes",
                          6 "value": [
                          7 {
                          8 "name": "SELF_CERTIFICATION",
                          9 "value": "true"
                          10 }
                          11 ]
                          12}

                          The PATCH request payload includes the value array. To certify that you have provided all necessary merchant information for verification, set value.name to SELF-CERTIFICATION and value.value to true. Self-certify your merchant information to ensure the account verification succeeds and the account does not get stuck in an intermediary state.

                          For more information, see Update merchant accounts.

                          Use PATCH to correct information

                          If your merchant has incorrect information that needs to be corrected, use the PATCH method to replace the incorrect data.

                          The following example shows how to replace the SSN in a US merchant account.

                            1curl --location --request PATCH 'https://<Host>/v3/customer/managed-accounts/<Account-ID>’
                            2[
                            3{
                            4 "op": "replace",
                            5 "path": "/individual_owners/@id=='{{individual_owner_id}}'/identification_documents/-",
                            6 "value": {
                            7 "type":"SOCIAL_SECURITY_NUMBER",
                            8 "identification_number":"151221234",
                            9 "issuing_country_code":"US"
                            10 }
                            11}
                            12]

                            Replacement is rarely required for merchants in the US. You only have one electronic verification attempt in the US, so you must provide documents to complete verification. However, your merchant may notice other inaccurate information, which you can update using the PATCH method.

                            Use POST to send documents

                            If your merchant needs to provide a document to complete verification, use the Supporting Documents API. The following example shows how to submit the Proof of Identity in the United States.

                              1curl -v -X \
                              2
                              3POST https://api-m.sandbox.paypal.com/v1/customer/supporting-documents \
                              4
                              5-H "Content-Type: multipart/form-data; boundary=WebKitFormBoundarydCVmGbjc9rWllBlE" \
                              6
                              7-H "Authorization: Bearer Access-Token" \
                              8
                              9-F 'input={"document_info": "{"document_type":"DRIVERS_LICENSE"}"};type=application/json' \
                              10
                              11-F 'driver_licence_front_and_back=@driver_licence_front_and_back.jpeg' \
                              5

                              Monitor for webhooks

                              After you submit all your documentation for your merchant account, PayPal begins the electronic or manual verification, depending on the region.

                              In both cases, the following webhooks are triggered:

                              • CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATED
                              • CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED

                              CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATE

                              PayPal sends this webhook notification when the merchant account update occurs.

                              The following example shows a CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATED webhook for a US merchant account.


                                1{
                                2 "description": "Account update webhook.",
                                3 "title": "Update Account",
                                4 "runnable": true,
                                5 "operationId": "webhook.account_updated",
                                6 "request": {
                                7 "path": "v1/notifications/webhooks-events/WH-3AE50806EM5305732-8C457463XB353952R",
                                8 "method": "GET",
                                9 "headers": {
                                10 "Authorization": "Bearer zekwhYgsYYI0zDg0p_Nf5v78VelCfYR0"
                                11 }
                                12 },
                                13 "response": {
                                14 "status": "200 OK",
                                15 "headers": {},
                                16 "body": {
                                17 "id": "WH-3AE50806EM5305732-8C457463XB353952R",
                                18 "event_version": "1.0",
                                19 "update_time": "2018-05-24T07:18:28.264Z",
                                20 "resource_type": "managed-accounts",
                                21 "event_type": "CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATED",
                                22 "summary": "A managed account was updated.",
                                23 "resource": {
                                24 "account_id": "7G4EPEEPEF74L",
                                25 "external_id": "external_id_353535335",
                                26 "links": [
                                27 {
                                28 "rel": "self",
                                29 "href": "https://api-m.paypal.com/v3/customer/managed-accounts/7G4EPEEPEF74L",
                                30 "method": "GET"
                                31 }
                                32 ]
                                33 },
                                34 "application_context": {
                                35 "event_context": "INFO",
                                36 "event_targets": [
                                37 "business_entity.phone_numbers",
                                38 "business_entity.identification_documents"
                                39 ]
                                40 },
                                41 "links": [
                                42 {
                                43 "href": "https://api-m.paypal.com/v1/notfications/webhooks-events/WH-3AE50806EM5305732-8C457463XB353952R",
                                44 "rel": "self",
                                45 "method": "GET"
                                46 },
                                47 {
                                48 "href": "https://api-m.paypal.com/v1/notfications/webhooks-events/WH-3AE50806EM5305732-8C457463XB353952R/resend",
                                49 "rel": "resend",
                                50 "method": "POST"
                                51 }
                                52 ]
                                53 }
                                54 }
                                55}

                                CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED

                                PayPal sends this webhook notification when the merchant account verification begins.

                                The following example shows a CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED webhook for a US merchant account.

                                  1{
                                  2 "description": "Account status changed webhook.",
                                  3 "title": "Account Status Changed",
                                  4 "runnable": true,
                                  5 "operationId": "webhook.account_status_changed",
                                  6 "request": {
                                  7 "path": "v1/notifications/webhooks-events/WH-3AE50806EM5305732-8C457463XB353952R",
                                  8 "method": "GET",
                                  9 "headers": {
                                  10 "Authorization": "Bearer zekwhYgsYYI0zDg0p_Nf5v78VelCfYR0"
                                  11 }
                                  12 },
                                  13 "response": {
                                  14 "status": "200 OK",
                                  15 "headers": {},
                                  16 "body": {
                                  17 "id": "WH-73186841AE655754N-74C4436203650953C",
                                  18 "event_version": "1.0",
                                  19 "create_time": "2022-01-07T19:23:30.000Z",
                                  20 "resource_type": "managed-accounts",
                                  21 "event_type": "CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED",
                                  22 "summary": "An account status has been changed",
                                  23 "resource": {
                                  24 "processes": [
                                  25 {
                                  26 "name": "MANAGED_PATH_BO_VERIFICATION",
                                  27 "status": "COMPLETED"
                                  28 },
                                  29 {
                                  30 "name": "MANAGED_PATH_KYC",
                                  31 "status": "NEED_MORE_DATA"
                                  32 }
                                  33 ],
                                  34 "document_rejections_reasons": [
                                  35 {
                                  36 "entity": "$.individual_owners[?(@['id']=='TP9PNVXEVYSG2')]",
                                  37 "name": "SOCIAL_SECURITY_NUMBER",
                                  38 "rejection_reasons": [
                                  39 {
                                  40 "rejection_code": "PARTIAL_DOCUMENT_RECEIVED",
                                  41 "description": "Front and Back both copies are not provided"
                                  42 }
                                  43 ]
                                  44 }
                                  45 ],
                                  46 "account_id": "TP9PNVXEVYSG2",
                                  47 "capabilities": [
                                  48 {
                                  49 "name": "RECEIVE_MONEY",
                                  50 "status": "ACTIVE"
                                  51 },
                                  52 {
                                  53 "name": "SEND_MONEY",
                                  54 "status": "ACTIVE"
                                  55 },
                                  56 {
                                  57 "name": "CUSTOM_CARD_PROCESSING",
                                  58 "status": "ACTIVE"
                                  59 },
                                  60 {
                                  61 "name": "WITHDRAW_MONEY",
                                  62 "status": "ACTIVE"
                                  63 },
                                  64 {
                                  65 "name": "CUSTOM_BANK_PROCESSING",
                                  66 "status": "ACTIVE"
                                  67 }
                                  68 ],
                                  69 "application_context": {
                                  70 "event_context": "ACTION"
                                  71 },
                                  72 "external_id": "EXT-1641583295",
                                  73 "links": [
                                  74 {
                                  75 "rel": "self",
                                  76 "href": "https://api.paypal.com/v3/customer/managed-accounts/TP9PNVXEVYSG2",
                                  77 "method": "GET"
                                  78 },
                                  79 {
                                  80 "href": "https://api.sandbox.paypal.com/v1/notifications/webhooks-events/WH-73186841AE655754N-74C4436203650953C/resend",
                                  81 "rel": "resend",
                                  82 "method": "POST"
                                  83 }
                                  84 ]
                                  85 },
                                  86 "links": [
                                  87 {
                                  88 "href": "https://api.sandbox.paypal.com/v1/notifications/webhooks-events/WH-73186841AE655754N-74C4436203650953C",
                                  89 "rel": "self",
                                  90 "method": "GET"
                                  91 }
                                  92 ]
                                  93 }
                                  94 },
                                  95 "description": "Account state changes for Capabilities or Processes",
                                  96 "title": "Account state change",
                                  97 "runnable": true,
                                  98 "operationId": "webhook.account_status_changed",
                                  99 "request": {
                                  100 "path": "v1/notifications/webhooks-events/WH-3AE50806EM5305732-8C457463XB353952R",
                                  101 "method": "GET",
                                  102 "headers": {
                                  103 "Authorization": "Bearer zekwhYgsYYI0zDg0p_Nf5v78VelCfYR0"
                                  104 }
                                  105 },
                                  106 "response": {
                                  107 "status": "200 OK",
                                  108 "headers": {},
                                  109 "body": {
                                  110 "id": "WH-3AE50806EM5305732-8C457463XB353952R",
                                  111 "event_version": "1.0",
                                  112 "create_time": "2019-01-25T07:18:28.264Z",
                                  113 "resource_type": "managed-accounts",
                                  114 "event_type": "CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED",
                                  115 "summary": "Managed account capability status changed.",
                                  116 "resource": {
                                  117 "account_id": "7G4EPEEPEF74L",
                                  118 "external_id": "external_id_353535335",
                                  119 "capabilities": [
                                  120 {
                                  121 "name": "CUSTOM_CARD_PROCESSING",
                                  122 "status": "ACTIVE"
                                  123 },
                                  124 {
                                  125 "name": "GOOGLE_PAY",
                                  126 "status": "REVOKED"
                                  127 },
                                  128 {
                                  129 "name": "APPLE_PAY",
                                  130 "status": "SUSPENDED"
                                  131 },
                                  132 {
                                  133 "name": "WITHDRAW_MONEY",
                                  134 "status": "NEED_DATA"
                                  135 },
                                  136 {
                                  137 "name": "SEND_MONEY",
                                  138 "status": "INACTIVE"
                                  139 },
                                  140 {
                                  141 "name": "RECEIVE_MONEY",
                                  142 "status": "ACTIVE"
                                  143 }
                                  144 ],
                                  145 "links": [
                                  146 {
                                  147 "rel": "self",
                                  148 "href": "https://api-m.paypal.com/v3/customer/managed-accounts/7G4EPEEPEF74L",
                                  149 "method": "GET"
                                  150 },
                                  151 {
                                  152 "rel": "edit",
                                  153 "href": "https://api-m.paypal.com/v3/customer/managed-accounts/7G4EPEEPEF74L",
                                  154 "method": "PATCH"
                                  155 }
                                  156 ]
                                  157 },
                                  158 "application_context": {
                                  159 "event_context": "ACTION"
                                  160 },
                                  161 "links": [
                                  162 {
                                  163 "href": "https://api-m.paypal.com/v1/notifications/webhooks-events/WH-3AE50806EM5305732-8C457463XB353952R",
                                  164 "rel": "self",
                                  165 "method": "GET"
                                  166 },
                                  167 {
                                  168 "href": "https://api-m.paypal.com/v1/notifications/webhooks-events/WH-3AE50806EM5305732-8C457463XB353952R/resend",
                                  169 "rel": "resend",
                                  170 "method": "POST"
                                  171 }
                                  172 ]
                                  173 }
                                  174 }
                                  175}

                                  After receiving this webhook, complete a GET request to /v3/customer/managed-accounts/{id} to determine next steps.

                                  6

                                  Analyze JSON response to verify or request more information

                                  Use the capabilities array to determine if the verification on the merchant account is completed.

                                  If PayPal completes a manual document review, the capabilities array shows the "status": "MANUAL_REVIEW. At this point, you do not need to provide additional information. PayPal's operations teams review all documents within 24 hours and will provide further details. After the review, you receive an ACCOUNT-STATUS-CHANGED response. Make a GET call to determine the next steps.

                                  Sample response for a merchant account under manual review (US)


                                    1{
                                    2 "process_view": {
                                    3 "processes": [
                                    4 {
                                    5 "name": "MANAGED_PATH_KYC_VERIFICATION",
                                    6 "status": "MANUAL_REVIEW",
                                    7 "capabilities": [
                                    8 {
                                    9 "name": "RECEIVE_MONEY",
                                    10 "limits": [
                                    11 {
                                    12 "type": "AMOUNT",
                                    13 "unit": "USD",
                                    14 "value": "5000.00",
                                    15 "remaining_value": "5000.00",
                                    16 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    17 }
                                    18 ],
                                    19 "grace_periods": [
                                    20 {
                                    21 "start_time": "2024-02-05T20:40:37.110Z",
                                    22 "expiry_time": "2024-03-06T20:40:37.110Z"
                                    23 }
                                    24 ]
                                    25 },
                                    26 {
                                    27 "name": "CUSTOM_CARD_PROCESSING",
                                    28 "limits": [
                                    29 {
                                    30 "type": "AMOUNT",
                                    31 "unit": "USD",
                                    32 "value": "5000.00",
                                    33 "remaining_value": "5000.00",
                                    34 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    35 }
                                    36 ],
                                    37 "grace_periods": [
                                    38 {
                                    39 "start_time": "2024-02-05T20:40:37.110Z",
                                    40 "expiry_time": "2024-03-06T20:40:37.110Z"
                                    41 }
                                    42 ]
                                    43 },
                                    44 {
                                    45 "name": "WITHDRAW_MONEY"
                                    46 },
                                    47 {
                                    48 "name": "GOOGLE_PAY",
                                    49 "limits": [
                                    50 {
                                    51 "type": "AMOUNT",
                                    52 "unit": "USD",
                                    53 "value": "5000.00",
                                    54 "remaining_value": "5000.00",
                                    55 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    56 }
                                    57 ],
                                    58 "grace_periods": [
                                    59 {
                                    60 "start_time": "2024-02-05T20:40:37.110Z",
                                    61 "expiry_time": "2024-03-06T20:40:37.110Z"
                                    62 }
                                    63 ]
                                    64 },
                                    65 {
                                    66 "name": "APPLE_PAY",
                                    67 "limits": [
                                    68 {
                                    69 "type": "AMOUNT",
                                    70 "unit": "USD",
                                    71 "value": "5000.00",
                                    72 "remaining_value": "5000.00",
                                    73 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    74 }
                                    75 ],
                                    76 "grace_periods": [
                                    77 {
                                    78 "start_time": "2024-02-05T20:40:37.110Z",
                                    79 "expiry_time": "2024-03-06T20:40:37.110Z"
                                    80 }
                                    81 ]
                                    82 }
                                    83 ]
                                    84 },
                                    85 {
                                    86 "name": "MANAGED_PATH_BO_VERIFICATION",
                                    87 "status": "MANUAL_REVIEW",
                                    88 "capabilities": [
                                    89 {
                                    90 "name": "APPLE_PAY",
                                    91 "limits": [
                                    92 {
                                    93 "type": "AMOUNT",
                                    94 "unit": "USD",
                                    95 "value": "500000.00",
                                    96 "remaining_value": "500000.00",
                                    97 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    98 }
                                    99 ]
                                    100 },
                                    101 {
                                    102 "name": "CUSTOM_CARD_PROCESSING",
                                    103 "limits": [
                                    104 {
                                    105 "type": "AMOUNT",
                                    106 "unit": "USD",
                                    107 "value": "500000.00",
                                    108 "remaining_value": "500000.00",
                                    109 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    110 }
                                    111 ]
                                    112 },
                                    113 {
                                    114 "name": "RECEIVE_MONEY",
                                    115 "limits": [
                                    116 {
                                    117 "type": "AMOUNT",
                                    118 "unit": "USD",
                                    119 "value": "500000.00",
                                    120 "remaining_value": "500000.00",
                                    121 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    122 }
                                    123 ]
                                    124 },
                                    125 {
                                    126 "name": "GOOGLE_PAY",
                                    127 "limits": [
                                    128 {
                                    129 "type": "AMOUNT",
                                    130 "unit": "USD",
                                    131 "value": "500000.00",
                                    132 "remaining_value": "500000.00",
                                    133 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    134 }
                                    135 ]
                                    136 },
                                    137 {
                                    138 "name": "WITHDRAW_MONEY",
                                    139 "limits": [
                                    140 {
                                    141 "type": "AMOUNT",
                                    142 "unit": "USD",
                                    143 "value": "500000.00",
                                    144 "remaining_value": "500000.00",
                                    145 "implication_of_limit_breach": "BLOCK_CAPABILITY"
                                    146 }
                                    147 ]
                                    148 }
                                    149 ]
                                    150 },
                                    151 {
                                    152 "name": "MANAGED_PATH_BO_COLLECTION",
                                    153 "status": "COMPLETED",
                                    154 "capabilities": [
                                    155 {
                                    156 "name": "CUSTOM_CARD_PROCESSING"
                                    157 },
                                    158 {
                                    159 "name": "RECEIVE_MONEY"
                                    160 },
                                    161 {
                                    162 "name": "APPLE_PAY"
                                    163 },
                                    164 {
                                    165 "name": "WITHDRAW_MONEY"
                                    166 },
                                    167 {
                                    168 "name": "GOOGLE_PAY"
                                    169 }
                                    170 ]
                                    171 },
                                    172 {
                                    173 "name": "MANAGED_PATH_KYC_COLLECTION",
                                    174 "status": "COMPLETED",
                                    175 "capabilities": [
                                    176 {
                                    177 "name": "APPLE_PAY"
                                    178 },
                                    179 {
                                    180 "name": "CUSTOM_CARD_PROCESSING"
                                    181 },
                                    182 {
                                    183 "name": "WITHDRAW_MONEY"
                                    184 },
                                    185 {
                                    186 "name": "GOOGLE_PAY"
                                    187 },
                                    188 {
                                    189 "name": "RECEIVE_MONEY"
                                    190 }
                                    191 ]
                                    192 }
                                    193 ]
                                    194 }
                                    195}
                                    • After PayPal completes the electronic or manual verification on the merchant account, all sections under the capabilities array shows "status": "ACTIVE" and no limitations.
                                    • If the merchant needs to provide more information or documents to proceed, the response shows "status": "ACTIVE" with a "limits" block or "status": "NEED_DATA".
                                    • If any "capabilities" do not have "status: ACTIVE", use the process_view method to find all the information you need to communicate to your merchants on how to proceed.

                                    For more information, see Analyze JSON Response.

                                    Sample response: Documentation is rejected

                                    If PayPal reviews and rejects the merchant's document, you'll see a new section in the process_view method called "document_rejections_reasons. This section shows the reasons for the rejection of the documents. You can localize the description of the reason and share it directly with your customers, or you can edit it to match your company's voice.

                                    In the following example, a document is rejected for a US merchant account because the document is too blurry and has missing pages.

                                      1{
                                      2 "document_rejections_reasons": [
                                      3 {
                                      4 "id": "cDY7L",
                                      5 "name": "SSN",
                                      6 "entity": "$.business_entity.office_bearers[?(@['id'] == 'R2Y2ZQGHCN5BE')]",
                                      7 "rejection_reasons": [
                                      8 {
                                      9 "rejection_code": "PARTIAL_DOCUMENT_RECEIVED",
                                      10 "description": "We only received a portion of the SSN document you provided. Please upload a new document that shows the entire page or pages. Please don't cover or mask any of the information shown on the document."
                                      11 },
                                      12 {
                                      13 "rejection_code": "DOCUMENT_RESOLUTION_LOW",
                                      14 "description": "The document you provided is illegible, because it’s either too blurry, too bright, too dark, or the resolution is low. Please upload a new document that can be easily read."
                                      15 }
                                      16 ]
                                      17 }
                                      18 ]
                                      19}

                                      Reasons for document rejection

                                      The following table lists the reasons why PayPal may reject the submitted documentation.

                                      Rejection Reasons

                                      Description

                                      Geography

                                      POI_EXPIRED

                                      The proof of identity document you provided has expired. Please upload a current proof of identity document.

                                      Global

                                      POA_VALIDITY_PASSED_3_MONTHS

                                      The proof of address document you provided was not issued within the last 3 months. Please upload a new proof of address document with the correct issue date.

                                      Global

                                      POI_MISSING_ISSUE_

                                      OR_EXPIRY_DATE

                                      The proof of identity document you provided doesn't include an issue date or expiration date. Please upload a new proof of identity document showing one of these.

                                      Global

                                      PARTIAL_DOCUMENT_RECEIVED

                                      We only received a portion of the <Doc_Type> document you provided. Please upload a new document that shows the entire page or pages. Please don't cover or mask any of the information shown on the document.

                                      Global

                                      POI_ONLY_BIRTH_
                                      CERTIFICATE_RECEIVED

                                      We received your birth certificate, but also need a supporting document. Please provide a government document (tax authority letter, social welfare letter) or by an authorized financial service entity (bank/card statement) that confirms your name and address.

                                      EU, MX

                                      POA_DATE_OF_ISSUE_MISSING

                                      Proof of address document is missing the date it was issued. Please upload a new document showing your current address and the date the document was issued.

                                      Global

                                      POA_LOGO_OR_FOOTER_MISSING

                                      The proof of address document you provided is missing a logo or footer. Please upload a new document that includes a logo or footer.

                                      EU, MX, TH

                                      MISSING_RESIDENTIAL_ADDRESS

                                      The proof of address document you provided includes a P.O. box instead of a residential address. Unfortunately, we can't accept P.O. boxes. Please upload a new document that includes your residential address.

                                      Global

                                      SINGLE_DOCUMENT_RECEIVED_

                                      FOR_POI_AND_POA

                                      You provided one document to prove both your identity and your address. Please upload a separate document for each.

                                      Global

                                      WRONG_DOCUMENT_RECEIVED

                                      The document you provided for <Doc_Type> was incorrect. Please log in to your account and follow the instructions in your notification to upload a new document.

                                      Global

                                      ONE_SIDE_OF_DOCUMENT_RECEIVED

                                      We only received one page of the <Doc_Type> document you provided. Please upload a new document that shows both pages.

                                      Global

                                      DOCUMENT_RESOLUTION_LOW

                                      The document you provided is illegible, because it's either too blurry, too bright, too dark, or the resolution is low . Please upload a new document that can be easily read.

                                      Global

                                      UNABLE_TO_OPEN_PDF

                                      We can't open the PDF you provided. Please upload a new document.

                                      Global

                                      DOCUMENT_FIRSTNAME_

                                      DOES_NOT_MATCH

                                      The first name shown on document you provided doesn't match the first name shown in your account. Please provide a new document that includes the same first name shown in your account.

                                      Global

                                      DOCUMENT_SURNAME_
                                      DOES_NOT_MATCH

                                      The last name shown on document you provided doesn't match the last name shown in your account. Please provide a new document that includes the same last name shown in your account.

                                      Global

                                      DOCUMENT_COMPLETE_

                                      NAME_DOES_NOT_MATCH

                                      The first and last name shown on document you provided doesn't match the first and last name on your account. Please provide a new document that includes the same first and last name on your account.

                                      Global

                                      NON_RESIDENTIAL_ADDRESS_

                                      IN_CUSTOMER_PROFILE

                                      Please update your account with a residential address.

                                      Global

                                      POA_ADDRESS_NOT_MATCHING_

                                      ADDRESS_IN_PROFILE

                                      The address shown on your proof of address document doesn't match the address on your account. Please update either your proof of address document or the address on your account.

                                      Global

                                      INCOMPLETE_PARTIAL_ADDRESS

                                      The proof of address document you provided doesn't show a complete address. Please upload a new proof of address document that includes the full address.

                                      Global

                                      BUSINESS_DOC_LEGAL_

                                      NAME_MISTMATCH

                                      The business name shown in the business document you provided doesn't match the name shown in your PayPal account. Please update legal business name (as applicable) and upload a new proof of business document with a legal business name that matches the one shown in your PayPal account.

                                      AU, BR, IN TH, US

                                      NAME_CHANGE_
                                      SUPPORTING_DOCUMENT

                                      If you have legally changed your name, please provide a copy of the legal document (i.e. marriage certificate, divorce decree) confirming the change.

                                      Global

                                      CONTACT_NAME_CHANGE

                                      The name shown in your identity document doesn't match the name used on your account. If you want to change the name in your profile, please upload a letter on company stationery that includes:- The current and new account holder's names- Reason for the name change - The email address, postal address and phone number as registered on your account.

                                      Global

                                      NONE_GOVT_ISSUED_ID

                                      The proof of identity document you provided is not a government issued photo ID. Please provide a new document to confirm your identity.

                                      Global

                                      UNDERAGE_BUSINESS_PAU

                                      The contact person listed on the document you provided is a minor. The contact person of your account must be the age of majority in your jurisdiction. Please change the contact person on your account and upload a document for the new contact person.

                                      CA

                                      POA_VIRTUAL_OR_

                                      PO_BOX_ADDRESS

                                      The document you provided contains a P.O. Box or a virtual address. We require a physical address for verification. Please update your account, if necessary, and upload a new document issued within 12 months that includes a physical business address and company name.

                                      CA

                                      UPGRADE_NOT_ALLOWED

                                      Our records indicate that this account was created as an individual account. If you want an account for a legal entity business, please open a new business account.

                                      CA

                                      DOWNGRADE_CLOSE_ACCOUNT

                                      Our records indicate that you may have signed up for an account with the wrong business type. Unfortunately, we are unable to change your current account to the correct business type. If you want to change your business type, please sign up for a new account.

                                      CA

                                      BO_POA

                                      Please upload a new document as a proof of address for the beneficial owner.

                                      CA

                                      PROOF_OF_BUSINESS_STRUCTURE

                                      Please provide a document confirming the organizational structure of your business, including the names of beneficial owners and/or individuals with control rights. We can accept one of the following: •Official supporting documentation (e.g. Corporate tree etc.) •Securities register •Shareholders register •Shareholder Agreement •Partnership Agreement.

                                      CA

                                      BUSINESS_CROSS_JURISDICTION

                                      The document you have provided shows your business is registered in a different country. Please provide us a business registration document showing your registration in Canada.

                                      CA

                                      EU_LOA_MISSING_ELEMENTS

                                      The letter of authorization you provided is missing some information. Please upload a new document that includes: -The PayPal account holder's full name and position in the company-The business name and business registration number as it appears on your business registration document-The full name, position in the company and signature of a duly authorized person (such as, CEO, CFO, managing director, or chairperson).

                                      EU

                                      POA_VIRTUAL_ADDRESS

                                      The proof of address document you provided contains a virtual address. Please upload a new document (e.g., utility bill) that includes a physical business address and company name.

                                      EU

                                      BUSINESS_DOC_MISSING_ELEMENTS

                                      The business document your provided is missing some of the required information. Please upload a new business document containing: company name, business registration number and business address.

                                      EU, MX, TH

                                      FA_DECLARATION_RECEIVED

                                      We received you Club Declaration Statement, but we also need a bank statement. Please upload a bank statement that includes the name of the club.

                                      EU

                                      FA_DECLARATION_
                                      MISSING_SIGNATURE

                                      The Club Declaration Statement you provided is missing a signature. Please provide a new copy of the declaration with a signature and printed name from a Club Chair, Secretary, or Treasurer. You can download the declaration form on the Whole Game System payments portal.

                                      EU

                                      EU_PARTNERSHIP_AGREEMENT_

                                      MISSING_ELEMENT

                                      The business document you provided is missing some information about your partnership. Please upload a new business document that includes:-The partnership name-The full names of all partners-Signatures of all partners

                                      EU

                                      EU_VAT_DECLARATION_

                                      MISSING_ELEMENT

                                      The VAT Declaration you provided is missing some information. Please upload a new VAT Declaration from your local tax authority that includes:- The partnership name- Full names of all partners

                                      EU

                                      EU_UNREGISTERED_CHARITY

                                      The tax exemption document you provided doesn't include a charity name. Please upload a new document that includes your charity name as it's registered on your account.

                                      EU

                                      EU_UNREGISTERED_CHARITY_

                                      MISSING_SUPPORTING_DOCUMENTS

                                      We received your government issued tax exemption document, but we also need a bank statement. Please upload a bank statement that shows the charity name.

                                      EU

                                      UK_CHARITY_DOCUMENTS

                                      We received your company house registration number, but we also need you to upload a government-issued tax exemption document for your charity.

                                      EU

                                      ES_CIF_CARD_REQUIRED

                                      The business document you provided is missing the business registration number. Please upload a copy of a CIF card showing your business registration number (no provisional numbers please) and electronic code.

                                      EU

                                      IT_BUSINESS_DOCUMENT_REA

                                      The business document you provided shows the regional number (REA). Please upload a new document containing a codice fiscale/partita di IVA (VISURA o Partita di IVA).

                                      EU

                                      SSN_INCOMPLETE_NUMBER

                                      The document you provided is missing the full SSN/ITIN number. Please upload a new document that includes the full 9-digit SSN/ITIN number.

                                      US

                                      DOCUMENT_EXPIRED_

                                      OVER_12_MONTHS

                                      The document you provided wasn't issued within the last 12 months. Please upload a new document with the correct issue date.

                                      Global

                                      BUSINESS_POI_MISSING_ELEMENT

                                      The proof of business identity document you provided is missing some required information. Please upload a new business document that includes the business name registered on your account and the 9-digit TIN or EIN.

                                      US

                                      INITIALS_ON_DOCUMENT

                                      The document you provided includes only the initials of the first name. Please upload a new document that includes your full first and last name.

                                      Global

                                      PARTING_WAYS_ISSUED

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      POI_MISSING_DOB

                                      The proof of identity document you provided doesn't include the complete date of birth. Please upload a new document showing the entire date of birth.

                                      Global

                                      MISSING_BUSINESS_ADDRESS

                                      The proof of business address document provided contains a P.O. box. Unfortunately, we do not accept P.O. boxes as proof of address. Please upload a new document confirming your physical business address.

                                      Global

                                      WRONG_NAME_ON_DOCUMENT

                                      The document you provided doesn't include your name. Please upload a new document that includes your full name as shown on your account.

                                      Global

                                      NAME_CHANGE_LETTER_

                                      MISSING_INFO

                                      The name change letter you provided is missing some of the required information. Please upload a new letter on company stationery showing:-Current and new contact name-Reason for the name change -Email address, postal address and phone number as shown on your account.

                                      Global

                                      PAU_IS_MINOR

                                      The contact person listed on the document you provided is a minor. The contact person must be at least 18 years old. To change the contact name, please upload a letter o company stationery showing:- Current and new contact names- Reason for the name change - Email address, postal address and phone number as registered on your account. Please ensure that Letter of Authorization for the new Contact Name is also provided.

                                      EU, RU, AU, JP, 3PL, MX, TH, US, C2

                                      AU_CA_NICK_NAME_CHANGE

                                      The name on the document you provided doesn't match the name on your account. If you want to update the name on your account, please upload a bank statement for the bank account linked to your account along with a proof of address document.

                                      AU, CA

                                      BUSINESS_NAME_INSTEAD_

                                      OF_PERSONAL_NAME

                                      The document you provided shows the name of your business and not the person's name. Please upload a new document showing the person's name.

                                      Global

                                      BUSINESS_POA_WITH_PERSON_NAME

                                      The proof of business address document you provided shows a person's name instead of the business name. Please upload a new document showing the business name.

                                      Global

                                      SU_INCOMPLETE_ADDRESS

                                      The address provided for the secondary user of the account is incomplete. Please provide a full home address for your secondary user.

                                      Global

                                      INDIVIDUAL_POA_MISSING_INFO

                                      The proof of address document you providing is missing some information. Please upload a new proof of address document showing the full name and residential address that matches the one on your account.

                                      Global

                                      DOCUMENT_ILLEGIBLE_

                                      CANNOT_READ_INFORMATION

                                      The document you provided is illegible, because it's either too blurry, too bright, too dark, or the resolution is low. Please upload a new document that can be easily read.

                                      Global

                                      PDF_PASSWORD_PROTECTED

                                      We can't open the PDF you provided because it's password-protected. Please upload your document again without password protection or in a different format.

                                      Global

                                      BUSINESS_POA_MISSING_ELEMENT

                                      The proof of business address document you provided is missing some required information. Please upload a new proof of business address document issued within the last 12 months that includes the business name and physical business address registered on your account.

                                      US, TH

                                      BUSINESS_NAME_DOESNT_

                                      MATCH_ACCT_INFO

                                      The business name on the document you provided doesn't match the business name registered on your account. Please upload a new proof of business identity document that includes the name registered on your account, or update the business name on your account.

                                      US, TH

                                      BUSINESS_NAME_AND_EIN_

                                      DOESNT_MATCH_ACCT_INFO

                                      The business name and EIN shown in the document you provided doesn't match the EIN and business name on your account. Please upload a new proof of business identity document that includes the EIN and business name on your account. If you were trying to add information for a different business entity to the current account, please open a separate account for your new business.

                                      US

                                      BUSINESS_TYPE_
                                      BLANK_MISMATCHING

                                      The business identity document you provided includes a business type that doesn't match the business type on your account. Please update the business type in your account to match what's shown on your documents, and then upload the original document again once you're done.

                                      US

                                      CLARIFY_BUSINESS_TYPE

                                      Please update the business type shown in your account to confirm if you are an Individual, Sole Proprietor or business entity (partnership, private limited, government entity, public company, etc.). Once the business type is updated, please upload your document again.

                                      US

                                      POA_IN_DIFFERENT_COUNTRY_

                                      NEW_DOC_REQUIRED

                                      We can't accept the document you provided, because the address shown on the document is in a country different than the one on your account. Please upload a new document that includes the address shown in your account.

                                      Global

                                      DOC_NOT_IN_ENGLISH

                                      We can't accept the document you provided, because it's in a regional language. Please provide a copy of this document that's been translated to English and notarized by a government official.

                                      Global

                                      LOA_NOT_SIGNED_BY_

                                      DIRECTOR_COMPANY_EXECUTIVE

                                      It looks like the person who signed the Letter of Authorisation is not listed as an Authorised Representative or Company Executive on your account. Please have your Letter of Authorisation signed by the correct stakeholder and re-submit. update_authorised.para=It looks like the person who signed the Letter of Authorisation is not listed as an Authorised Representative or Company Executive on your account. You'll need to add this stakeholder and re-submit. Once added, you can re-submit the Letter of Authorisation. complete_name.para=It looks like the info we received doesn't match the info on your account. To fix this, you need to upload a copy of a legal document (marriage certificate, divorce certificate, etc) to confirm your name change. You'll also need to upload copy of your passport with your new legal name.<br/><br/

                                      EU

                                      LOA_UPDATE_AUTHORISED_

                                      REPRESENTATIVE

                                      It looks like the person who signed the Letter of Authorisation is not listed as an Authorised Representative or Company Executive on your account. Please have your Letter of Authorisation signed by the correct stakeholder and re-submit.

                                      EU

                                      PARTING_WAYS_ISSUED_

                                      FALSIFIED_DOCUMENTS

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      PARTING_WAYS_ISSUED_

                                      UNDERAGE_CUSTOMER

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      PARTING_WAYS_ISSUED_

                                      UNDERAGE_CUSTOMER_AT_SIGNUP

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      PARTING_WAYS_ISSUED_FALSE_NAME

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      PARTING_WAYS_ISSUED_

                                      UNSUPPORTED_CITIZENSHIP

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      RU

                                      PARTING_WAYS_ISSUED_

                                      UNSUPPORTED_COUNTRY

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      PARTING_WAYS_ISSUED_

                                      WRONG_COUNTRY

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      PARTING_WAYS_ISSUED_

                                      CROSS_JURIDSICTIONAL_ACCOUNT

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      EU

                                      PARTING_WAYS_ISSUED_

                                      INACTIVE_BUSINESS

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      DOCUMENT_BLURRED_

                                      CANNOT_READ_INFORMATION

                                      The document you provided is illegible, because it's either too blurry, too bright, too dark, or the resolution is low. Please upload a new document that can be easily read.

                                      US, C2

                                      DOCUMENT_TOO_BRIGHT_

                                      CANNOT_READ_INFORMATION

                                      The document you provided is illegible, because it's either too blurry, too bright, too dark, or the resolution is low. Please upload a new document that can be easily read.

                                      US, C2

                                      POI_PORTRAIT_PHOTO_MISSING

                                      Your selfie could not be verified. Please complete a new selfie. Ensure there are no other individuals in the frame and that you are capturing an image of your face.

                                      US, C2

                                      KEY_INFORMATION_TAMPERED_

                                      OR_COVERED

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      US, C2

                                      NON_POI_DOCUMENT

                                      No Content - Should be removed from scope

                                      US, C2

                                      POI_DOB_DOES_NOT_MATCH

                                      No Content - Should be removed from scope

                                      US, C2

                                      REJECTED_AND_CUSTOMIZED_

                                      COMMUNICATION_NEEDED

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      CLOSED_ACCOUNT

                                      After reviewing the information you provided, we have decided not to proceed for security reasons.

                                      Global

                                      PPCC_CHARITABLE_
                                      STATUS_DOC_REQ

                                      Please upload a document demonstrating your organization's charitable status, for example a certificate of tax exemption, or a document from the relevant regulator confirming that your organization's work benefits for general public.

                                      US

                                      DOC_ILLEGIBLE_UNABLE TO OPEN

                                      We are unable to accept the document provided either because is too blurry, too bright, too dark or we are unable to open the file. Please upload a new document that can be easily read.

                                      Global

                                      DOC_INFORMATION_MISMATCH

                                      The information on the <doc Type> provided does not match the information on your account. Please update the information on your account as required and upload a new document.

                                      US

                                      BANK_STATMENT_ REQ

                                      To complete our review please upload a bank statement for the bank account linked to your account.

                                      US

                                      VOIDED_CHECK_OR_
                                      BANK_STATEMENT

                                      To complete our review, please provide the following documentation: - A copy of a bank statement or voided check that includes the charity or nonprofit organization's name and address pre-printed on it. Please send us a copy for a bank account you have registered your account. Please also note that any bank account you add to your account must be under the ownership of the charity/nonprofit organization and cannot be a personal bank account and must be active in your account. Please keep in mind that we reserve the right to ask additional questions on your policies and procedures.

                                      US

                                      BUSINESS_NAME_MISMATCH

                                      The business name on the documentation you provided does not match the Business name on your account. Please provide the following additional information: - A subordination letter on official letterhead from signed by an officer/director/trustee of the parent organization clearly stating that you are an authorized subordinate organization on behalf of the parent organization. Or If you have used a trading name or full legal business name, please provide the following additional information: - Written authorization on company letterhead, instructing us that you have used your trading name or full legal business name on your account. This letter must contain a company stamp and signature of a director or legal authorizer. Please keep in mind that we reserve the right to ask additional questions on your policies and procedures.

                                      US

                                      BUSINESS_NAME_IN_PAU_FIELD

                                      While reviewing your account, we were unable to verify the contact name on your account because it is listed as a business name. The contact name must be your name, not a business name. You can change the contact name on your account. To process your name, change request, we require additional information. Please provide: - Photo ID: You can use your driver's license, passport, or any other government issued photo ID. Please keep in mind that we reserve the right to ask additional questions on your policies and procedures. We look forward to hearing from you and thank you.

                                      US

                                      EIN_MISMATCH

                                      To complete our review, please complete the following: Update the EIN on your account to reflect the information on the document provided. Or Submit a tax exempt document matching Business name and EIN registered on the account. Please keep in mind that we reserve the right to ask additional questions on your policies and procedures.

                                      US

                                      7

                                      Complete verification

                                      Repeat steps 2-6 until the merchant passes all verification checks and all sections under the "capabilities" array shows "status: ACTIVE" with no limits.

                                        1"capabilities":[
                                        2 {
                                        3 "name": "APPLE_PAY",
                                        4 "status": "ACTIVE"
                                        5 },
                                        6 {
                                        7 "name": "GOOGLE_PAY",
                                        8 "status": "ACTIVE"
                                        9 },
                                        10 {
                                        11 "name": "CUSTOM_CARD_PROCESSING",
                                        12 "status": "ACTIVE"
                                        13 },
                                        14 {
                                        15 "name": "RECEIVE_MONEY",
                                        16 "status": "ACTIVE"
                                        17 },
                                        18 {
                                        19 "name": "WITHDRAW_MONEY",
                                        20 "status": "ACTIVE"
                                        21 }
                                        22]

                                        We use cookies to improve your experience on our site. May we use marketing cookies to show you personalized ads? Manage all cookies