RecorrênciaCriar recorrência
Criar recorrência
/v1/recurrencyhttps://api.securitypag.comAutenticação: Bearer · chave de API
Use a rota v1/recurrency para criar uma cobrança que se repete a cada ciclo. No Pix Automático a recorrência nasce PENDING e espera o pagador autorizar. No cartão, a adquirente pode já cobrar a primeira parcela na criação, e aí ela nasce ACTIVE ou FAILED; se a cobrança ficar para depois, nasce PENDING e vira ACTIVE quando a primeira cobrança for paga.
Corpo da requisição
Enviado em JSON.
- amountintegerobrigatório
Valor cobrado a cada ciclo em centavos. Exemplo: R$ 1,00.
- currencystringobrigatório
Moeda da recorrência. Hoje só
BRLtem método de recorrência. - methodstringobrigatório
Método de recorrência (
PIXAUTOMATIC,CREDIT_CARD). - descriptionstringobrigatório
Descrição da recorrência. Vai para a adquirente e o pagador vê no extrato e nos avisos dela.
- frequencystringobrigatório
Frequência da cobrança (
WEEKLY,MONTHLY,QUARTERLY,SEMIANNUALLY,ANNUALLY). - customerobjectobrigatório5 campos
Dados de quem está pagando a recorrência.
- namestringobrigatório
Nome completo do pagador.
- taxIdstringobrigatório
Documento do pagador.
- emailstringobrigatório
E-mail do pagador.
- phonestring
Telefone do pagador. Pode ser obrigatório em algumas operadoras.
- addressobjectobrigatório8 campos
Endereço de cobrança.
- countrystringobrigatório
Código do país no padrão
ISO3166-1 alpha-2 (ex: BR, US). - statestringobrigatório
Estado ou província (ex: SP, CA, NY). Obrigatório quando country = BR.
- citystringobrigatório
Cidade. Obrigatório quando country = BR.
- districtstringobrigatório
Bairro. Obrigatório quando country = BR.
- streetstringobrigatório
Nome da rua ou logradouro. Obrigatório quando country = BR.
- numberstringobrigatório
Número do endereço. Obrigatório quando country = BR.
- complementstring
Complemento do endereço (apartamento, bloco, unidade, etc).
- zipCodestringobrigatório
CEPou código postal.
- externalRefstring
Referência externa da recorrência.
- notificationUrlstring
URLpara onde os webhooks da recorrência serão enviados. - splitsarray of strings
Lista de IDs de splits. Exemplo: ["split_id_1", "split_id_2"].
- metadataobject10 campos
Metadados do pagamento utilizados para rastreabilidade e controle.
- providerstringobrigatório
Identificador da origem responsável pela criação do pagamento, como checkout, aplicativo, painel administrativo ou integração externa.
- orderIdstringobrigatório
Identificador único do pedido no sistema.
- sellerTaxIdstringobrigatório
Documento fiscal do vendedor recebedor do pagamento.
- sellerEmailstringobrigatório
E-mail do vendedor recebedor do pagamento.
- checkoutUrlstring
URLdo checkout onde o pagamento foi iniciado. - memberProductUrlstring
Página do produto da área de membros que originou a compra.
- returnUrlstring
URLde redirecionamento após o fluxo de pagamento. - shopUrlstring
Página de venda ou oferta que originou a intenção de compra.
- referrerLinkstring
URLde origem imediata do acesso do usuário antes de chegar à página de venda. - extrastring
Campo livre para armazenamento de metadados adicionais.
Respostas
200Recorrência criada. O status depende do meio e de a adquirente ter cobrado na hora: PENDING, ACTIVE ou FAILED.
403A loja não tem recorrência liberada para este meio ou moeda.
422O valor está fora do ticket mínimo ou máximo configurado para a loja.
- messagestring
Mensagem descritiva do erro.
- detailsobject
Detalhes adicionais do erro.
400Erro de validação no corpo da requisição.
Algo errado nesta página? Fale com o time