Перейти к основному содержимому

Управление кредитными линиями | Документация для разработчиков

Управление кредитными линиями

Обновлено: 12 декабря 2025 г
В этом документе описывается, как партнеры по решениям могут предоставлять и отзывать кредитные линии с подключенными бизнес-клиентами.
Раскрытие информации об ответственности за выставление счетов
Для корпоративных клиентов, которых вы подключаете через встроенную регистрацию, необходимо предоставить доступ к вашей кредитной линии в Meta для оплаты доступа к платформе WhatsApp Business. Это означает, что компании платят вам, а вы получаете сводный счет для оплаты Meta.
Вы являетесь «плательщиком» для всех компаний, использующих вашу кредитную линию. Вы несете ответственность и будете оплачивать Meta все расходы, понесенные этими компаниями через платформу WhatsApp Business.
Вы можете предоставить доступ к своей кредитной линии, используя API, описанные в этом документе. Вы можете отозвать доступ к своей кредитной линии для отдельных предприятий в рамках Meta Business Suite или с помощью серии вызовов API .

Аутентификация и авторизация

Практически для всех конечных точек, связанных с кредитными линиями, требуется токен доступа системного пользователя. Кроме того, системный пользователь, которому принадлежит токен, должен предоставить вашему приложению business_management и иметь администратора или финансового редактора в вашем бизнес-портфеле.

Получать идентификатор вашей кредитной линии

Практически все вызовы API, связанные с кредитными линиями, требуют указания идентификатора вашей кредитной линии. Используйте его ПОЛУЧАТЬ /<BUSINESS_ID> /расширенные кредиты Конечная точка для получения идентификатора кредитной линии вашего бизнес-портфеля.

Синтаксис запроса

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>
    


    

    Необходимый.
    

    Ваш системный токен.
    


    

    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    

    

    

    

    Ответ
    

    В случае успеха:
    

    

    {
    
"allocation_config_id":
    
"58501441721238",
    
"waba_id":
    
"102290129340398"
}
    Параметры отклика
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <ALLOCATION_CONFIGURATION_ID>
    


    

    Идентификатор конфигурации распределения расширенной кредитной линии.
    

    Сохраните этот идентификатор, если хотите убедиться  что информация о вашей кредитной линии была предоставлена ​​клиенту.
    


    

    58501441721238
    



    

    <CUSTOMER_WABA_ID>
    


    

    Идентификатор WABA клиента.
    


    

    102290129340398
    

    

    

    Альтернативный
способ совместного использования кредитной линии
    В настоящее время мы тестируем новые шаги для предоставления доступа к вашей кредитной линии уже подключенным бизнес-клиентам. Эти шаги описаны ниже и в конечном итоге заменят предыдущие текущий метод за предоставление кредитной линии другому клиенту, уже подключенному к системе.
    Шаг 1: Получите идентификатор бизнес-портфеля вашего клиента
    Используйте ПОЛУЧАТЬ /<WABA_ID> конечную точку и запросить информация о владельце бизнеса поле для получения идентификатора бизнес-портфеля клиента.
    Синтаксис запроса
    curl --get 'https://graph.facebook.com/v21.0/<WABA_ID> ?fields=owner_business_info' \ -H 'Авторизация: Bearer'<BUSINESS_TOKEN> '
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <BUSINESS_TOKEN>
    Необходимый.
    Бизнес-токен клиента.
    EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
    <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
    Шаг 2: Предоставьте информацию о вашей кредитной линии компании клиента
    Используйте ПОЧТА /<EXTENDED_CREDIT_ID> /whatsapp_credit_sharing конечная точка и ваша системный токен чтобы указать на ваше намерение поделиться своей кредитной линией с бизнес-портфелем клиента.
    Синтаксис запроса
    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>
    Необходимый.
    Токен доступа системного пользователя.
    EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
    Пример ответа
    В случае успеха:
      "success": true, "allocation_config_id": "58501441721238" }
    Параметры отклика
    
Заполнитель

Описание

Пример значения

    <ALLOCATION_CONFIG_ID>
    Идентификатор конфигурации распределения расширенной кредитной линии.
    58501441721238
    Шаг 3: Привяжите свою кредитную линию к WABA клиента
    Используйте ПОЧТА /<EXTENDED_CREDIT_LINE_ID> /whatsapp_credit_attach Конечная точка для привязки вашей кредитной линии к WABA клиента.
    Примечание: После привязки к 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>
    Необходимый.
    Бизнес-токен клиента.
    EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
    <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>
    Идентификатор конфигурации распределения расширенной кредитной линии.
    Сохраните этот ID, если хотите проверять что ваша кредитная линия была предоставлена ​​клиенту.
    58501441721238
    <WABA_ID>
    Идентификатор WABA клиента.
    102290129340398
    Теперь ваша кредитная линия должна быть предоставлена ​​корпоративному клиенту. Чтобы убедиться, что она действительно была предоставлена, см Проверка того, что ваша кредитная линия была предоставлена ​​клиенту.
    Проверка статуса общего доступа
    Выполните следующие запросы, если хотите убедиться, что ваша кредитная линия была предоставлена ​​подключенному бизнес-клиенту.
    Шаг 1: Получите учетные данные для приема платежей по кредитной линии
    Используйте ПОЛУЧАТЬ /<EXTENDED_CREDIT_ALLOCATION_ID> конечная точка для запроса получение_учетных_данных поле в вашем идентификаторе расширенного распределения кредитов (возвращается, когда вы поделились своей кредитной линией (с корпоративным клиентом).
    Синтаксис запроса
    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
    Используйте ПОЛУЧАТЬ /<WABA> конечная точка для запроса 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 для информации.
    Шаг 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": "УДАЛЕНО" }
    Поиск неисправностей
    

    

    

    

    Необщие бизнес-аккаунты WhatsApp
    

    Если корпоративный клиент откажется предоставлять вам доступ к своему аккаунту WABA или удалит вас из списка партнеров своего бизнес-аккаунта WhatsApp, вы не сможете получить идентификатор его бизнес-портфеля через API.
    

    Вместо этого вы можете получить идентификатор их портфеля из уведомления по электронной почте, отправленного администраторам бизнес-портфеля, когда бизнес-клиент удаляет вас из числа партнеров или отменяет общий доступ к своему WABA.
    

    Когда доступ к вашему аккаунту WABA прекращается, вся переписка по этому аккаунту блокируется для защиты вашей кредитной линии. Для обеспечения полной безопасности мы рекомендуем отозвать вашу кредитную линию у бизнес-клиента по его аккаунту WABA сразу после прекращения доступа к нему.
    

    

    

    

    См. также
    

      Ссылка: БизнесСсылка: Бизнес-аккаунт WhatsAppСсылка: Расширенный кредит
      
    
              
      
    
      

            
      
        
      
    
      

    
      

    
    
      
        
      
             Вернуться наверх