POST/payments/customers

Criar

Request Body

required

object

Corpo para criar um cliente de pagamento

typerequiredstring

Tipo de cliente. - `INDIVIDUAL`: identificado por `cpf`. - `BUSINESS`: identificado por `cnpj`.

INDIVIDUALBUSINESS

namerequiredstring

Nome do cliente

emailstring

Email do cliente

cpfstring

CPF do cliente. Obrigatório quando `type=INDIVIDUAL`.

cnpjstring

CNPJ do cliente. Obrigatório quando `type=BUSINESS`.

connectorIdnumber

ID do conector padrão a ser usado no fluxo de iniciação de pagamento do Pluggy (https://pay.pluggy.ai) pelo pagador.

Example

json

{
  "type": "INDIVIDUAL",
  "name": "Marco Silva",
  "email": "marco.silva@example.com",
  "cpf": "22222222222"
}

Responses

200Crie um cliente de pagamento.

object

Resposta com informações relacionadas a um cliente de pagamento

idrequiredstring

Identificador principal

typerequiredstring

Tipo de cliente. - `INDIVIDUAL`: identificado por `cpf`. - `BUSINESS`: identificado por `cnpj`.

INDIVIDUALBUSINESS

namerequiredstring

Nome do cliente

emailstring

Email do cliente

cpfstring

CPF do Cliente

cnpjstring

CNPJ do cliente, se o tipo for `BUSINESS`

connectorobject

Objeto do conector

idrequirednumber (integer)

Identificador principal

namestring

Nome da instituição

institutionUrlstring

Página inicial da instituição

imageUrlstring

Imagem do logotipo hospedado pelo Pluggy

primaryColorstring

Cor primária

typestring

Tipo de instituição

countrystring

País localizado

credentialsobject[]

Parâmetros necessários para iniciar a conexão

hasMFAboolean

O conector requer um MFA para ser executado?

productsstring[]

Produtos suportados pelo conector

productCoveragestring[]

Quais subprodutos a instituição oferece, na própria terminologia do diretório de Open Finance (por exemplo, INVESTMENTS:TREASURE_TITLES, CREDIT_OPERATIONS:INVOICE_FINANCINGS). Onde produtos indicam se o conector atende a investimentos, isso diz quais: um conector que lista INVESTMENTS pode atender a um dos cinco recursos de investimento ou a todos os cinco. Ausente para conectores diretos, que não têm participantes de Open Finance.

oauthboolean

Se 'true', o conector requerirá um fluxo Oauth para ser executado

oauthUrlstring

URL para realizar o fluxo Oauth, se necessário

resetPasswordUrlstring

URL para a instituição financeira para redefinir a senha

healthobject

Status de saúde do conector

isOpenFinanceboolean

Indica se o conector utiliza as APIs regulamentadas de Open Finance

isSandboxboolean

Indica se o conector é um conector de sandbox, destinado a testes em vez de uma instituição real

supportsPaymentInitiationboolean

Indica se o conector suporta a API de iniciação de pagamento

supportsScheduledPaymentsboolean

Indica se o conector suporta pagamentos agendados

supportsSmartTransfersboolean

Indica se o conector suporta transferências inteligentes

supportsBoletoManagementboolean

Indica se o conector suporta gerenciamento de boleto

supportsAutomaticPixboolean

Indica se o conector suporta Pix automático

createdAtstring (date-time)

Data de criação

updatedAtstring (date-time)

Data da última modificação

createdAtrequiredstring (date-time)

Data em que o cliente foi criado

updatedAtrequiredstring (date-time)

Data da última atualização do cliente

Example response

json

{
  "id": "5e9f8f8f-f8f8-4f8f-8f8f-8f8f8f8f8f8f",
  "type": "INDIVIDUAL",
  "name": "Marco Silva",
  "email": "marco.silva@example.com",
  "cpf": "222.222.222-22",
  "cnpj": null,
  "connector": null,
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

curl -X POST \
  'https://api.pluggy.ai/payments/customers' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -d '{ "type": "INDIVIDUAL", "name": "Marco Silva", "email": "marco.silva@example.com", "cpf": "22222222222" }'

Resposta de exemplo

{
  "id": "5e9f8f8f-f8f8-4f8f-8f8f-8f8f8f8f8f8f",
  "type": "INDIVIDUAL",
  "name": "Marco Silva",
  "email": "marco.silva@example.com",
  "cpf": "222.222.222-22",
  "cnpj": null,
  "connector": null,
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}