v1

latestOpenAPI 3.1.02026-07-24750514.9 KB

Criar assinante

post/customers

Headers

Authorizationstring required

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

x-idempotency-keystring

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).

Request body

reference_idstring

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

namestring

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

emailstring

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

tax_idstring

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.⚠️

birth_datestring date

Data de nascimento do assinante. <br><small>Exemplo: 2000-12-20</small>

Response

200

idstring
reference_idstring
emailstring
namestring
tax_idstring
birth_datestring
created_atstring
updated_atstring

Example response

{
  "id": "CUST_2E9290E4-8149-4AEE-8A6B-F04055EFCEA1",
  "reference_id": "Seu_NOVO_ID_de_referencia",
  "email": "novo.email.do.cliente@empresa.com.br",
  "name": "Novo Nome do seu cliente",
  "tax_id": "55046023008",
  "phones": [
    {
      "id": 1,
      "area": "21",
      "country": "55",
      "number": "33334444"
    }
  ],
  "birth_date": "1985-10-11",
  "address": {
    "street": "Rua Com Billing Info",
    "number": "456778",
    "complement": "casa 1",
    "locality": "Barra",
    "city": "Rio de Janeiro",
    "region_code": "RJ",
    "country": "BRA",
    "postal_code": "20081240"
  },
  "billing_info": [
    {
      "type": "CREDIT_CARD",
      "card": {
        "token": "TOKE_6DEA1FC4-91B6-4FA7-982C-DEE22ADEB2B9",
        "brand": "visa",
        "first_digits": "411111",
        "last_digits": "1111",
        "exp_month": "11",
        "exp_year": "2034",
        "holder": {
          "name": "Riquinho Rico"
        }
      }
    }
  ],
  "created_at": "2022-06-09T10:13:06.841889-03:00",
  "updated_at": "2022-08-05T16:58:43.993088-03:00",
  "links": [
    {
      "rel": "SELF",
      "href": "http://sandbox.api.assinaturas.pagseguro.com/customers/CUST_2E9290E4-8149-4AEE-8A6B-F04055EFCEA1",
      "media": "application/json",
      "type": "GET"
    }
  ]
}