Управление кредитными линиями | Документация для разработчиков
Управление кредитными линиями
Обновлено: 12 декабря 2025 г
В этом документе описывается, как партнеры по решениям могут предоставлять и отзывать кредитные линии с подключенными бизнес-клиентами.
Раскрытие информации об ответственности за выставление счетов
Для корпоративных клиентов, которых вы подключаете через встроенную регистрацию, необходимо предоставить доступ к вашей кредитной линии в Meta для оплаты доступа к платформе WhatsApp Business. Это означает, что компании платят вам, а вы получаете сводный счет для оплаты Meta.
Вы являетесь «плательщиком» для всех компаний, использующих вашу кредитную линию. Вы несете ответственность и будете оплачивать Meta все расходы, понесенные этими компаниями через платформу WhatsApp Business.
Вы можете предоставить доступ к своей кредитной линии, используя API, описанные в этом документе. Вы можете отозвать доступ к своей кредитной линии для отдельных предприятий в рамках Meta Business Suite или с помощью серии вызовов API .
Аутентификация и авторизация
Практически для всех конечных точек, связанных с кредитными линиями, требуется токен доступа системного пользователя. Кроме того, системный пользователь, которому принадлежит токен, должен предоставить вашему приложению business_management и иметь администратора или финансового редактора в вашем бизнес-портфеле.
Получите идентификатор вашей кредитной линии
Практически все вызовы API, связанные с кредитными линиями, требуют указания идентификатора вашей кредитной линии. Используйте метод GET /
Синтаксис запроса
curl 'https://graph.facebook.com/<API_VERSION> /<BUSINESS_ID> /extendedcredits' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> '
Пример запроса
curl 'https://graph.facebook.com/v24.0/102289599326934/extendedcredits' \ -H 'Авторизация: Bearer EAAJi...'
Ответ
В случае успеха API вернет расширенный идентификатор кредитной линии бизнес-портфеля («идентификатор кредитной линии»).
{ "data": [ { "id": "1972385232742146" } ] }Совместное использование кредитной линии
В настоящее время мы тестируем новые шаги для предоставления доступа к вашей кредитной линии уже подключенным бизнес-клиентам. Эти шаги в конечном итоге заменят предыдущий, поэтому, если вы хотите внедрить их сейчас, обратитесь к альтернативному методу предоставления доступа к вашей кредитной линии, описанному ниже.
Используйте POST / /whatsapp_credit_sharing_and_attach — конечная точка для предоставления доступа к вашей кредитной линии подключенному бизнес-клиенту.
Синтаксис запроса
curl -X POST 'https://graph.facebook.com/<API_VERSION> /<EXTENDED_CREDIT_LINE_ID> /whatsapp_credit_sharing_and_attach?waba_currency=<CUSTOMER_BUSINESS_CURRENCY> &waba_id=<CUSTOMER_WABA_ID> ' \ -H 'Авторизация: Предъявитель<SYSTEM_TOKEN> '
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<CUSTOMER_BUSINESS_CURRENCY> | Необходимый. Валюта компании представлена в виде трехбуквенного кода валюты. Поддерживаемые значения: АУДевроФунт стерлинговИДРмРНКдоллар СШАЭта валюта используется для выставления счетов и соответствует ценовым ставкам. | доллар США |
<CUSTOMER_WABA_ID> | Необходимый. Идентификатор WABA клиента. | 102290129340398 |
<EXTENDED_CREDIT_LINE_ID> | Необходимый. Идентификатор вашей расширенной кредитной линии. | 1972385232742146 |
<SYSTEM_TOKEN> | Необходимый. Ваш системный токен. | |
Ответ
В случае успеха:
{ "allocation_config_id": "58501441721238", "waba_id": "102290129340398" }Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ALLOCATION_CONFIGURATION_ID> | Идентификатор конфигурации распределения расширенной кредитной линии. Сохраните этот идентификатор, если хотите убедиться что информация о вашей кредитной линии была предоставлена клиенту. | 58501441721238 |
<CUSTOMER_WABA_ID> | Идентификатор WABA клиента. | 102290129340398 |
Альтернативный способ поделиться своей кредитной линией
В настоящее время мы тестируем новые шаги для предоставления доступа к вашей кредитной линии уже подключенным бизнес-клиентам. Эти шаги описаны ниже и в конечном итоге заменят текущий способ предоставления доступа к вашей кредитной линии подключенным клиентам.
Шаг 1: Получите идентификатор бизнес-портфеля вашего клиента
Используйте GET /
owner_business_info , чтобы получить идентификатор бизнес-портфеля клиента.Синтаксис запроса
curl --get 'https://graph.facebook.com/v21.0/<WABA_ID> ?fields=owner_business_info' \ -H 'Авторизация: Bearer'<BUSINESS_TOKEN> '
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BUSINESS_TOKEN> | Необходимый. Бизнес-токен клиента. | |
<WABA_ID> | Необходимый. Идентификатор WABA клиента. | 102290129340398 |
Синтаксис ответа
В случае успеха:
{ "owner_business_info": { "name": "<BUSINESS_PORTFOLIO_NAME> ", "идентификатор": "<BUSINESS_PORTFOLIO_ID> " }, "идентификатор": "<WABA_ID> " }Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BUSINESS_PORTFOLIO_ID> | Идентификатор бизнес-портфеля клиента. | 2729063490586005 |
<BUSINESS_PORTFOLIO_NAME> | Название бизнес-портфеля клиента. | Ветер и шерсть |
<WABA_ID> | Идентификатор WABA клиента. | 102290129340398 |
Используйте POST /
Синтаксис запроса
curl -X POST 'https://graph.facebook.com/<API_VERSION> /<EXTENDED_CREDIT_LINE_ID> /whatsapp_credit_sharing?receiving_business_id=<BUSINESS_PORTFOLIO_ID> ' \ -H 'Авторизация: Предъявитель<SYSTEM_TOKEN> '
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<EXTENDED_CREDIT_LINE_ID> | Необходимый. Идентификатор вашей расширенной кредитной линии. | 5985499441566032 |
<BUSINESS_PORTFOLIO_ID> | Необходимый. Идентификатор бизнес-портфеля клиента. | 2729063490586005 |
<SYSTEM_TOKEN> | Необходимый. Токен доступа системного пользователя. | |
Пример ответа
В случае успеха:
"success": true, "allocation_config_id": "58501441721238" }
Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ALLOCATION_CONFIG_ID> | Идентификатор конфигурации распределения расширенной кредитной линии. | 58501441721238 |
Шаг 3: Привяжите свою кредитную линию к WABA клиента
Используйте POST /
Примечание: После привязки к WABA изменить кредитные линии невозможно. Если для WABA требуется другая кредитная линия, необходимо создать новую WABA, и затем к ней можно будет привязать новую кредитную линию.
Синтаксис запроса
curl -X POST 'https://graph.facebook.com/v21.0/<EXTENDED_CREDIT_LINE_ID> /whatsapp_credit_attach?waba_currency=<WABA_CURRENCY> &waba_id=<WABA_ID> ' \ -H 'Авторизация: Предъявитель<BUSINESS_TOKEN> '
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BUSINESS_TOKEN> | Необходимый. Бизнес-токен клиента. | |
<EXTENDED_CREDIT_LINE_ID> | Необходимый. Идентификатор вашей расширенной кредитной линии. | 5985499441566032 |
<WABA_ID> | Необходимый. Идентификатор WABA клиента. | 102290129340398 |
<WABA_CURRENCY> | Необходимый. Валюта, в которой работает клиент. | доллар США |
Синтаксис ответа
В случае успеха:
{ "success": true, "waba_id": "<WABA_ID> ", "allocation_config_id": "<ALLOCATION_CONFIG_ID> " }Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ALLOCATION_CONFIG_ID> | Идентификатор конфигурации распределения расширенной кредитной линии. Сохраните этот идентификатор, если хотите убедиться что информация о вашей кредитной линии была предоставлена клиенту. | 58501441721238 |
<WABA_ID> | Идентификатор WABA клиента. | 102290129340398 |
Теперь ваша кредитная линия должна быть предоставлена корпоративному клиенту. Чтобы убедиться в этом, см. раздел « Проверка предоставления вашей кредитной линии клиенту» .
Выполните следующие запросы, если хотите убедиться, что ваша кредитная линия была предоставлена подключенному бизнес-клиенту.
Шаг 1: Получите учетные данные для приема платежей по кредитной линии
Используйте GET /
receiving_credential в вашем идентификаторе расширенного кредитного лимита (возвращается, когда вы предоставили доступ к кредитной линии корпоративному клиенту).Синтаксис запроса
curl 'https://graph.facebook.com/<API_VERSION> /<EXTENDED_CREDIT_ALLOCATION_ID> ?fields=receiving_credential' \ -H 'Авторизация: Bearer'<SYSTEM_TOKEN> '
Синтаксис ответа
В случае успеха:
{ "receiving_credential": { "id": "<RECEIVING_CREDENTIAL_ID> " }, "идентификатор": "<ALLOCATION_CONFIGURATION_ID> " }Шаг 2: Получите основной идентификационный номер финансирования WABA
Используйте GET /
primary_funding_id по WABA-идентификатору клиента.Синтаксис запроса
curl 'https://graph.facebook.com/v21.0/<CUSTOMER_WABA_ID> /?fields=primary_funding_id' \ -H 'Авторизация: Bearer'<CUSTOMER_BUSINESS_TOKEN> '
Синтаксис ответа
В случае успеха:
{ "primary_funding_id": "<PRIMARY_FUNDING_ID> ", "идентификатор": "<CUSTOMER_WABA_ID> " }Шаг 3: Сравните идентификаторы
Сравните идентификатор учетных данных получателя с основным идентификатором финансирования. Если значения совпадают, значит, ваша кредитная линия корректно передана в WABA бизнес-клиента.
Вот шаги, необходимые для удаления общей кредитной линии, если вам нужно отозвать доступ по какой-либо причине. Вы можете отозвать свою кредитную линию в любое время, когда посчитаете это необходимым, и/или когда ваш клиент удалит вас из числа партнеров в своем бизнес-аккаунте WhatsApp.
При аннулировании кредитной линии на счете клиента это аннулирование распространяется на все WABA-счета, принадлежащие бизнесу клиента и предоставленные вам, партнеру по решениям.
Шаг 1: Получите идентификатор вашей кредитной линии
Пример запроса
curl -i -X GET "https://graph.facebook.com/v25.0/105954558954427/ extendedcredits?fields=id,legal_entity_name& access_token=EAAFl..."
Пример ответа
{ "data": [ { "id": "1972385232742146", //ID кредитной линии "legal_entity_name": "Ваше юридическое лицо", } ] }Шаг 2: Получите идентификатор бизнес-портфеля клиента
Если учетная запись WhatsApp Business в настоящее время используется совместно с партнером по решениям, получите идентификатор компании клиента из этой общей учетной записи WhatsApp Business.
В следующем примере используйте идентификатор назначенного бизнес-аккаунта WhatsApp.
Запрос:
Запрос:
curl -i -X GET "https://graph.facebook.com/v25.0/<WHATSAPP_BUSINESS_ACCOUNT_ID> ?fields=owner_business_info& access_token=<ACCESS_TOKEN> "
Ответ:
{ "owner_business_info": { "name": "Название компании клиента", "id": "1972385232742147" }, }Если учетная запись WhatsApp Business не была предоставлена партнеру по решениям или клиентская компания удалила партнера по решениям из своей учетной записи WhatsApp Business, вы не сможете получить доступ к идентификатору компании клиента из указанного выше вызова API. Дополнительную информацию см. в разделе « Неиспользованная учетная запись WhatsApp Business» .
Шаг 3: Получите данные о кредитной карте клиента
В следующем примере используйте идентификатор вашей кредитной линии в качестве расширенного идентификатора кредита.
Запрос:
curl -i -X GET "https://graph.facebook.com/<API_VERSION> /<EXTENDED_CREDIT_ID> / owning_credit_allocation_configs? receiving_business_id=<CLIENT_BUSINESS_ID> & fields=id,receiving_business& access_token=<SYSTEM_USER_ACCESS_TOKEN> "
Ответ:
{ "id": "1972385232742140", // Конфигурация распределения (т.е., совместное использование кредитов) id "receiving_business": { "name": "Название компании-клиента" "id": "1972385232742147" }, }Шаг 4: Отменить совместное использование кредитов
Запрос:
curl -i -X DELETE "https://graph.facebook.com/v25.0/ {allocation-config-id}? access_token={system-user-access-token}"
Ответ:
{ "success": true, }Шаг 5: Убедитесь, что предоставление кредита было отменено (необязательно)
Запрос:
curl -i -X GET "https://graph.facebook.com/v25.0/ {allocation-config-id}?fields=receiving_business,request_status& access_token={system-user-access-token}"
Ответ:
{ "receiving_business": { "name": "Название компании-клиента" "id": "1972385232742147" }, "request_status": "УДАЛЕНО" }Поиск неисправностей
Если корпоративный клиент откажется предоставлять вам доступ к своему аккаунту WABA или удалит вас из списка партнеров своего бизнес-аккаунта WhatsApp, вы не сможете получить идентификатор его бизнес-портфеля через API.
Вместо этого вы можете получить идентификатор их портфеля из уведомления по электронной почте, отправленного администраторам бизнес-портфеля, когда бизнес-клиент удаляет вас из числа партнеров или отменяет общий доступ к своему WABA.
Когда доступ к вашему аккаунту WABA прекращается, вся переписка по этому аккаунту блокируется для защиты вашей кредитной линии. Для обеспечения полной безопасности мы рекомендуем отозвать вашу кредитную линию у бизнес-клиента по его аккаунту WABA сразу после прекращения доступа к нему.
Комментарии отсутствуют
Комментарии отсутствуют