Esse artigo irá lhe ensinar como:
- Realizar a alteração de um método de pagamento.
- Consultar qual é o cartão default, ou padrão de um cliente.
- Consultar os últimos e primeiros dígitos de um cartão de crédito.
- Consultar todos os cartões de crédito salvos para um cliente.
Modelo de diagrama de sequência UML de integração:
ALTERANDO MÉTODO DE PAGAMENTO
“Cliente entra no site e gostaria de realizar a alteração do cartão de crédito de sua assinatura, ou pretende usar um novo para realizar a compra de um serviço, ou produto.”
Para realizar essa alteração é necessário realizar o processo de tokenização desse novo cartão de crédito, esse processo pode ser realizado de duas maneiras.
Se sua empresa não for PCI Dss, indicamos que utilize o iugu.js, ao inserir esse trecho de código javascript em sua webpage você garante que os dados de cartão de crédito serão transacionados apenas pelo front-end da sua aplicação, trazendo segurança para o seu negócio. O iugu.js irá te retorna um token que deve ser usado para criar a forma de pagamento ou realizar a cobrança direta.
Caso sua empresa seja certificada PCI DSS, pode ser realizando um POST na api “Criar Token”, onde será gerado um token id e retornado no response da api.
curl --location --request POST 'https://api.iugu.com/v1/payment_token?api_token={chaveapi} \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cfruid=ca1be8a3bc81800098d0c3711c4f38bddca4926f-1626092966' \
--data-raw '{
"data": {
"number": "4532 1887 3049 3626",
"verification_value": "141",
"first_name": "valdir ",
"last_name": "s beserra",
"month": "06",
"year": "2022"
},
"account_id": "E6495D15290D47D3950C2A723D07A24E",
"method": "credit_card"//,
//"test": true - essa propriedade se igual true não deixa cadastrar cartão de teste.
Modelo de response da API
Com esse token é preciso criar uma forma de pagamento, através da api “Criar Forma de Pagamento”, que irá retornar um id, “identificador” desse novo cartão crédito.
Modelo de request
curl --location --request POST 'https://api.iugu.com/v1/customers/F224FD03ED7F4F5892999B3600EABD94/payment_methods?api_token={chaveapi} \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cfruid=ca1be8a3bc81800098d0c3711c4f38bddca4926f-1626092966' \
--data-raw '{
"token": "31d033ce-c21f-44a3-afd4-ad547fb0eca7",
"description": "Teste valdir 3",
"set_as_default": true
}'
Modelo de response
Como esse cliente já tem uma forma de pagamento atrelada ao seu perfil, precisamos alterar a forma de pagamento do cliente, por tanto, precisamos realizar uma nova chamada na api “Alterar Forma de Pagamento”.
Modelo de request
curl --location --request PUT 'https://api.iugu.com/v1/customers/F224FD03ED7F4F5892999B3600EABD94/payment_methods/3515C25AEDDE4C95B5C29AFB3F406294?api_token={chaveapi} \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cfruid=ca1be8a3bc81800098d0c3711c4f38bddca4926f-1626092966' \
--data-raw ''
Modelo de response
Após realizado essa alteração as próximas cobranças da assinatura serão realizadas no novo cartão de crédito.
OBS. O mesmo processo se aplica, caso o cliente queira realizar a compra de um novo item no e-commerce, deve ser realizado o processo acima para alteração do cartão de crédito atrelado ao cliente.
COMO VALIDAR QUAL É O CARTÃO DE CRÉDITO ATRELADO A UMA DETERMINADA ASSINATURA?
Para consultar o cartão default de um cliente, basta realizar uma consulta na api “Buscar Cliente”, passando o id do cliente na url, onde será apresentado uma propriedade chamada default_payment_method_id.
Modelo de request:
curl --location -g --request GET 'https://api.iugu.com/v1/customers?api_token={chaveapi}&customer_id=D793ADC70D0D4880AFFFD1E1927FEB17' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cfruid=ca1be8a3bc81800098d0c3711c4f38bddca4926f-1626092966' \
--data-raw ''
Modelo de response
Com o id retornado na propriedade default_payment_method_id e o do cliente que é desejado consultar os dados do cartão, é possível consultar na api “Buscar Forma de Pagamento” os primeiros e últimos dígitos do cartão, onde será apresentado o seguinte response.
Modelo de request
curl --location --request GET 'https://api.iugu.com/v1/customers/F224FD03ED7F4F5892999B3600EABD94/payment_methods/3515C25AEDDE4C95B5C29AFB3F406294?api_token={chaveapi} \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cfruid=ca1be8a3bc81800098d0c3711c4f38bddca4926f-1626092966' \
--data-raw ''
Modelo de response
Na propriedade display_number é possível consumir os 4 últimos dígitos do cartão.
Já na propriedade bin é possível consumir os primeiros dígitos do cartão.
CONSULTAR OS CARTÕES DE CRÉDITO DE UM CLIENTE
Para consultar os cartões de crédito de um cliente basta realizar um GET na api “Listar Formas de Pagamento”, passando o id do cliente.
Modelo de request
curl --location --request GET 'https://api.iugu.com/v1/customers/F224FD03ED7F4F5892999B3600EABD94/payment_methods?api_token={chaveapi}\
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cfruid=ca1be8a3bc81800098d0c3711c4f38bddca4926f-1626092966' \
--data-raw ''
Modelo de retorno
0 Comentários