> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4seletpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Alterar Método de Pagamento
> Altera o método de pagamento de uma assinatura ativa (status `Recurring` ou `RecurringOverdue`). Ao mudar para `CreditCard`, os dados do novo cartão devem ser informados no objeto `card`.
Requer o header `account`. A assinatura precisa estar em status `Recurring` ou `RecurringOverdue`.
Ao mudar para `CreditCard`, os dados do novo cartão são obrigatórios no objeto `card`.
Métodos aceitos: `CreditCard`, `PIX`.
## OpenAPI
````yaml PUT /v1/subscriptions/change-payment-method/{subscription_code}
openapi: 3.1.0
info:
title: 4Selet Pay API
description: >
API de processamento de pagamentos da plataforma 4Selet Pay. Suporta
cobranças únicas, assinaturas recorrentes, PIX, Cartão de Crédito. Todas as
rotas autenticadas requerem um Bearer Token obtido via `/v1/login`.
version: 1.0.0
contact:
name: 4Selet Pay
email: suporte@4selet.com.br
servers:
- url: https://sandbox.4seletpay.com.br/api
description: Servidor de Sandbox
security:
- bearerAuth: []
tags:
- name: Autenticação
description: Rotas de autenticação e criação de usuários
- name: Cobranças
description: Criação, consulta, cancelamento e reembolso de cobranças
- name: Pedidos
description: Consulta de pedidos e gerenciamento de confirmações desafiadas
- name: Assinaturas
description: Criação e gerenciamento de assinaturas recorrentes
- name: Faturas
description: Gerenciamento de faturas e pagamento de faturas em atraso
- name: Clientes Bloqueados
description: Gerenciamento de lista negra de clientes
- name: Contas
description: Criação e gerenciamento de contas na plataforma
- name: Aplicativo
description: Endpoints para dashboard e uso via aplicativo mobile
- name: Notificações Push
description: Envio e gerenciamento de notificações push
- name: Utilitários
description: Endpoints utilitários como listagem de fusos horários
- name: Gestão
description: Relatórios gerenciais (acesso restrito a Super Admins)
- name: Webhooks
description: Endpoints para receber notificações de gateways de pagamento
- name: Endpoints de Webhook
description: >-
Gerenciamento de endpoints de webhook para receber notificações de eventos
da plataforma
- name: Links de Pagamento
description: Criação e gerenciamento de links de pagamento com checkout pré-configurado
paths:
/v1/subscriptions/change-payment-method/{subscription_code}:
put:
tags:
- Assinaturas
summary: Alterar método de pagamento da assinatura
description: >
Altera o método de pagamento de uma assinatura ativa (status `Recurring`
ou `RecurringOverdue`). Ao mudar para `CreditCard`, os dados do novo
cartão devem ser informados no objeto `card`.
operationId: changeSubscriptionPaymentMethod
parameters:
- $ref: '#/components/parameters/AccountHeader'
- name: subscription_code
in: path
required: true
description: Código único da assinatura
schema:
type: string
example: sub_abc123
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ChangePaymentMethodRequest'
examples:
para_pix:
summary: Mudar para PIX
value:
method: PIX
para_cartao:
summary: Mudar para Cartão de Crédito
value:
method: CreditCard
card:
name: CARLOS FERREIRA
number: '4111111111111111'
month: '12'
year: '28'
security_code: '321'
responses:
'200':
description: Método de pagamento alterado com sucesso
content:
application/json:
schema:
$ref: '#/components/schemas/SuccessResponse'
example:
mensagem: Método de pagamento alterado com sucesso
erro: false
mensagenserro: []
codigoretorno: 200
id: 00000000-0000-0000-0000-000000000000
data: []
'401':
$ref: '#/components/responses/Unauthorized'
'403':
description: Assinatura não pertence à conta informada
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
mensagem: Um erro inesperado acabou de acontecer.
erro: true
mensagenserro:
- O código da assinatura não é válido
codigoretorno: 403
id: 00000000-0000-0000-0000-000000000000
data: []
'404':
description: Assinatura não encontrada
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
mensagem: Um erro aconteceu.
erro: true
mensagenserro:
- Assinatura não encontrada
codigoretorno: 404
id: 00000000-0000-0000-0000-000000000000
data: []
'422':
description: >-
Assinatura não está ativa (não está em status Recurring ou
RecurringOverdue)
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
mensagem: Um erro aconteceu.
erro: true
mensagenserro:
- A assinatura não está ativa
codigoretorno: 422
id: 00000000-0000-0000-0000-000000000000
data: []
security:
- bearerAuth: []
components:
parameters:
AccountHeader:
name: account
in: header
required: true
description: Código da conta à qual a operação se aplica
schema:
type: string
example: acc_abc123xyz
schemas:
ChangePaymentMethodRequest:
type: object
required:
- method
properties:
method:
type: string
description: Novo método de pagamento (obrigatório)
enum:
- CreditCard
- PIX
example: PIX
card:
type: object
nullable: true
description: Dados do cartão (obrigatório se method=CreditCard)
properties:
name:
type: string
description: Nome no cartão
example: CARLOS FERREIRA
number:
type: string
description: Número do cartão
example: '4111111111111111'
month:
type: string
description: Mês de validade
example: '12'
year:
type: string
description: Ano de validade
example: '28'
security_code:
type: string
description: CVV
example: '321'
SuccessResponse:
type: object
properties:
mensagem:
type: string
example: Operação realizada com sucesso
erro:
type: boolean
example: false
mensagenserro:
type: array
items:
type: string
example: []
codigoretorno:
type: integer
example: 200
id:
type: string
example: 00000000-0000-0000-0000-000000000000
data:
description: Dados retornados pela operação (objeto, array ou vazio)
nullable: true
ErrorResponse:
type: object
properties:
mensagem:
type: string
example: Um erro inesperado acabou de acontecer.
erro:
type: boolean
example: true
mensagenserro:
type: array
items:
type: string
example:
- Detalhe do erro ocorrido.
codigoretorno:
type: integer
example: 400
id:
type: string
example: 00000000-0000-0000-0000-000000000000
data:
type: array
example: []
responses:
Unauthorized:
description: Não autorizado — token inválido ou ausente
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
mensagem: Unauthenticated.
erro: true
mensagenserro: []
codigoretorno: 401
id: 00000000-0000-0000-0000-000000000000
data: []
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
Token JWT obtido via `POST /v1/login`. Envie no header `Authorization:
Bearer `.
````