Criar assinante

post https://sandbox.api.assinaturas.pagseguro.com/customers

Utilize este endpoint para criar novos assinantes. Você precisa dos dados do assinante e do plano para gerar novas assinaturas.

📘
Acesse o guia do serviço de Pagamentos Recorrentes para mais informações sobre seu funcionamento e funcionalidades disponíveis. Você também pode consultar o guia específico da funcionalidade de assinantes.

Body Params

reference_id

string

Identificador único atribuído para o assinante. Utilizado internamente pelo vendedor em seu sistema (Max 65 caracteres).

name

string

Nome completo do assinante (Max 150 caracteres). ⚠️Obrigatório⚠️

string

E-mail válido do assinante (Max 60 caracteres). O e-mail deve ser diferente do e-mail do merchant (vendedor). ⚠️Obrigatório⚠️

tax_id

string

Número do documento do assinante, CPF com 11 dígitos e CNPJ com 14 dígitos numéricos. ⚠️Forneça apenas números. Obrigatório.⚠️

phones

array of objects

Objeto contendo o(s) telefone(s) do assinante. ⚠️Deve conter no mínimo um telefone.⚠️

phones

birth_date

date

Data de nascimento do assinante.
Exemplo: 2000-12-20

address

object

Objeto de detalhes do endereço do assinante.

billing_info

array of objects

Objeto com dados de pagamento do assinante.

billing_info

Headers

Authorization

string

required

Token de autenticação. Deve ser enviado no formato Bearer <token>.

x-idempotency-key

string

Chave composta de caracteres alfanumérico, exceto caracteres especiais. As chaves são recicladas depois de um intervalo não específico. Com isso, é garantido sua eficiência por 48 horas (Max 200 caracteres).

Responses

Language


xxxxxxxxxx
1
curl --request POST \
2
     --url https://sandbox.api.assinaturas.pagseguro.com/customers \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

📘

200200

400400