Search managed account through external id

Show details for managed accounts, based on search criteria.

The detailed description for the endpoint can be found on PayPal Developer Portal under Managed Accounts.

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

external_id

string

必需

The external_id query parameter can be used to request managed accounts with the given external_id. Searches for the managed account that has the given external_id. To locate a particular account, you should set this to the same value that you provided in the /external_id property in your Create Managed Account request.

示例值:

返回响应

🟢200200 - Get Account with Process View

application/json

Body

managed_accounts

array [object {14}]

必需

account_id

string

可选

legal_country_code

string

可选

individual_owners

array [object {5}]

可选

business_entity

object

可选

agreements

array [object {2}]

可选

external_id

string

可选

organization

string

可选

user_id

string

可选

financial_instruments

object

可选

primary_currency_code

string

可选

soft_descriptor

string

可选

capabilities

array [object {2}]

可选

process_view

object

可选

links

array [object {3}]

可选

示例

{
    "managed_accounts": [
        {
            "account_id": "N4UJ5Z7GUXWM8",
            "legal_country_code": "FR",
            "individual_owners": [
                {
                    "id": "N4UJ5Z7GUXWM8",
                    "names": [
                        {
                            "given_name": "TONY",
                            "surname": "MALLUWA",
                            "id": "LAZGPW7KPQQ3S",
                            "type": "LEGAL"
                        }
                    ],
                    "citizenship": "FR",
                    "primary_residence": {
                        "address_line_1": "Lane 100 W STR",
                        "admin_area_2": "Paris",
                        "postal_code": "75012",
                        "country_code": "FR"
                    },
                    "birth_details": {
                        "date_of_birth": "1990-01-01"
                    }
                }
            ],
            "business_entity": {
                "type": "INDIVIDUAL",
                "merchant_category_code": "5462",
                "incorporation_details": {},
                "names": [
                    {
                        "business_name": "Abishak MALLUWA",
                        "id": "RW9UBHCR7BTZ6",
                        "type": "LEGAL"
                    }
                ],
                "registered_business_address": {
                    "address_line_1": "30 Rue Erard",
                    "address_line_2": "BAT D4",
                    "admin_area_2": "Paris",
                    "postal_code": "75012",
                    "country_code": "FR"
                },
                "phone_numbers": [
                    {
                        "country_code": "33",
                        "national_number": "0182222222",
                        "id": "NU3UFGVL7BJHQ",
                        "type": "CUSTOMER_SERVICE"
                    }
                ],
                "declarations": [
                    {
                        "name": "TWENTY_FIVE_PERCENT_BENEFICIAL_OWNER",
                        "value": "NO"
                    }
                ]
            },
            "agreements": [
                {
                    "type": "TERMS_ACCEPTED",
                    "accepted_time": "2022-09-10T00:00:00Z"
                }
            ],
            "external_id": "EXT-1682048105",
            "organization": "us",
            "user_id": "1682048105",
            "financial_instruments": {
                "banks": [
                    {
                        "id": "BA-M8UJ2ST7HQYZC",
                        "last_4_digits": "6690",
                        "account_number_type": "INTERNATIONAL_BANK_ACCOUNT_NUMBER",
                        "account_type": "CHECKING",
                        "routing_number": "61262345",
                        "currency_code": "EUR",
                        "country_code": "DE",
                        "account_holder_details": {
                            "name": "Abishak MALLUWA"
                        },
                        "bank_name": "Bernhauser Bank eG",
                        "branch_location": "70794 Filderstadt DE"
                    }
                ]
            },
            "primary_currency_code": "EUR",
            "soft_descriptor": "ABISHAKMALL",
            "capabilities": [
                {
                    "name": "RECEIVE_MONEY",
                    "status": "ACTIVE"
                },
                {
                    "name": "WITHDRAW_MONEY",
                    "status": "ACTIVE"
                }
            ],
            "process_view": {
                "processes": [
                    {
                        "name": "MANAGED_PATH_CIP_COLLECTION",
                        "status": "COMPLETED",
                        "capabilities": [
                            {
                                "name": "WITHDRAW_MONEY"
                            },
                            {
                                "name": "RECEIVE_MONEY"
                            }
                        ]
                    },
                    {
                        "name": "MANAGED_PATH_KYC",
                        "status": "COMPLETED",
                        "capabilities": [
                            {
                                "name": "WITHDRAW_MONEY"
                            },
                            {
                                "name": "RECEIVE_MONEY"
                            }
                        ]
                    }
                ]
            },
            "links": [
                {
                    "href": "https://api-m.sandbox.paypal.com/v3/customer/managed-accounts/N4UJ5Z7GUXWM8",
                    "rel": "self",
                    "method": "GET"
                },
                {
                    "href": "https://api-m.sandbox.paypal.com/v3/customer/managed-accounts/N4UJ5Z7GUXWM8",
                    "rel": "edit",
                    "method": "PATCH"
                }
            ]
        }
    ]
}

🟢200200 - Get Account Without Process View

🟢200200 - No Managed Accounts Found

🟠400400 Bad Request - Invalid Query Parameter

Search managed account through external id

请求参数

示例代码

返回响应