Iframe: Salvar cartão

Esta API armazena com segurança as informações dos cartões, permitindo que o próprio usuário insira os dados diretamente em uma tela dedicada.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Exemplo de requisição:

URL de requisição com os parâmetros: cpf/cnpj e produto inseridos:

curl --location 'https://gateway.fixpay.com.br/v1/safelink/card/201920192000102/PRODUTO' \
--header 'Content-Type: application/json' \
--header 'token: XXXXXXXXXXXXXXXXXXXX' \

URL de requisição com os parâmetros: cpf/cnpj, produto e id_card inseridos:

curl --location 'https://gateway.fixpay.com.br/v1/safelink/card/201920192000102/PRODUTO?id_card=teste' \
--header 'Content-Type: application/json' \
--header 'token: XXXXXXXXXXXXXXXXXXXX' \

Ao enviar a requisição, esta API retornará um conteúdo HTML. Ao abrir esse HTML no navegador, o usuário visualizará a seguinte tela para preenchimento dos dados do cartão. Após a conclusão desse processo, o cartão será tokenizado, permitindo que os pagamentos futuros sejam realizados utilizando apenas o token gerado, sem a necessidade de informar novamente os dados do cartão.

Observação:
● Transação de Zero dólar: No momento em que é feita a requisição para salvar o cartão, é realizada uma validação na bandeira do cartão através de uma transação no valor de zero real.

Ao preencher os dados na tela de forma válida, o cartão será cadastrado no sistema:


Por motivos a mais de segurança, a informação do token não retornará na tela de sucesso, o mesmo será retornado apenas via Webhook, contendo as seguintes informações:

{
  "type": "CARDSAVE",
  "documento": "0000000000",
  "card_token": "111111If805FAHMTXWKNUD3Xlh111111",
  "card": "11111",
  "created_at": "0000-00-24T16:09:55.328084-03:00",
  "id_card":"teste"
}

Observação: A validação do cartão é realizada em nosso ambiente, quando o cartão não for válido o token retornará vazio no webhook.

📘

Aviso!

Ao utilizar esta API para salvar o cartão, guarde o token em local seguro, ele será utilizado posteriormente na rota de pagamento. Essas informações não serão disponibilizadas em outras consultas.

Path Params
string
required

Documento do cliente. Ex: CPF/CNPJ

string
required

Produto ao qual o cartão estará vinculado. Verificar com a equipe de integração Fix Pay

Query Params
string

Parâmetro opcional que serve para adicionar uma informação extra de identificação do cartão. Ele retorna no webhook somente quando enviado na requisição. Ex:https://gateway.fixpay.com.br/v1/safelink/card/201920192000102/PRODUTO?id_card=teste

Headers
string
required

(TOKEN API AQUI)

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json