Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Card
labelTokenização do cartão de crédito
Deck of Cards
idSubscriptions
Card
labelEndpoint Payment-Token

Esse método permite guardar as informações do cartão para que seja utilizado no processo de adesão.

Obs.: Todas as informações das requisições são fictícias e não teram valor de processamento.

Procedimento de criação da tokenização do cartão.

Usando o POST Payment-Token para associar o id do Customers.

Insira o id do Customers nesse exemplo iremos utilizar o 4292.....

Bloco de código
languageyml
titlePOST payment-token
{
  "customerId": "429203e1-3261-45a7-b83c-9eb78deb9fca" //Id gerado na criação do Customers
}

Parâmetros de Saída 

Armazena o Id disponibilizado no campo url: e5ceab4d-f0d9-484b-a6cb-d3b8ee8ca639

Bloco de código
languageyml
titleRESPONSE Payment-Token
{
    "id": "e5ceab4d-f0d9-484b-a6cb-d3b8ee8ca639",
    "status": "Received",
    "url": "/api/v1/payment-token/e5ceab4d-f0d9-484b-a6cb-d3b8ee8ca639",
    "date": "2023-09-27T19:15:29.3039488+00:00"
}

Coletando o id para realizar a gravação do cartão. 

Parâmetros de Entrada

Cole o id do campo url logo após o nome payment-token, exemplo abaixo:

Bloco de código
languageyml
titleGET Payment-Token
https://recorrencia.totvs.app/api/v1/payment-token/payment-token/e5ceab4d-f0d9-484b-a6cb-d3b8ee8ca639

Parâmetros de Saída

Bloco de código
languageyml
titleRESPONSE Payment-Token
{
    "id": "e5ceab4d-f0d9-484b-a6cb-d3b8ee8ca639",
    "customerId": "429203e1-3261-45a7-b83c-9eb78deb9fca",
    "nickname": null,
    "lastFourDigits": null,
    "checkoutPageLink": "https://dev.thex.cloud/checkout/page?t=eyJkYXRhIjoiVTJGc2RHVmtYMS9Db0pEMVNJZjlPQ3pPRXFSNnpuUTNXYTI4cW4wSUhOQmF4cGFqMjBmYzhVNjlUVXJIM0VTcTRFN0JjUTJlalB2a2ZvYlk5Z1RYblVMTUc3QzlmWEZjNEwwQWRHSExGTHpCVmNQb21kQWNlMnZqK042NHdJYWphdmhPektOMjRhTVlFcEE1YUJCU3gzbnVYdUNROHlMOUQ1WDdJeTlPZU03VHFmVncwVE92OUF4aHVGeDNVQ2svQW1FNmhpZmE0ZjFmNzc4V3o0NWtkR0Z4SGtvOGIzckowai9wSGpTVi91ZHFSTVhMZGZPeW1UL3cxeGtENmhXaG5Vcm9KaFNVRTQrbStJSk5nY0kyd2N6cjBYSVdVYWpjNS82QkJIUG1nMmJvbDM2aUJDbUVtdUdtdS9GSGpSbU5WRjZ2eDhCUW5MYkQvRXljK0RrWXZBbUNMNytRaW0zcHR0aS9aN3Z3cE1BMVZrbWtOdnVveGhNOUFqTHVhOWwwMEJqT1dXdmIyaTl2ZzVjMHEzcnRrY0hNTWNVUUZJYWluZVYvTW4zbjhYODdDRzNmdjdxNjU3SmJXbEE1bmVBMFovN3NIMWdtVlBZNWxUZVR3a01CWVp2MUJzNER1dVdUVzJiQ3YrTGl6bGpMdHZxOEhtUzBnT0lrdytkMkp4aHpkcm9TemxhdWtjSHJ5MUJHTUJHTDFkb1hxR3Q0TURPdDd4bllMbm9QN0hINWx3Z1hGaFk2TS9iRzNVcmswMld4TEptNWY2QXpXWFFUOXV4TEROMklyVG1JVWFid0x2eFUvQk01OFQ0dDlLSUhlWEpOR1N3NGRUQzhnK0JsVExxOXU0V3k1R3VEajI0QVVrYXRnWThBdEY3blhFQStpbWFwaWRxWGJmOG43T3RjNnVZeW5QTmJ1WW9VNytTaDlXeG1TSFFRWDRNMGovTkg2VDhjcDJOMXRBSlNpQVhkU3ZFM2R3cFVwbWR6c0ZUOTQ5YjhQQmROSTVqemU5SEpzU3ZPbFJ4eXNaNHpLU08zc3cwWVowK1BobW9HMHE4SkwyTEEzZzJGbmVGeDZ3dmNZWjhjNnZJOXY1eW5wNjJYeVhyVmMya0RYVVpkSlBLam1vZWIrTU5xaFoyRVZmVmphcmJ2c2ZSSjJpc2s3VmNvUGpwWFdpL09rMVVKTDk2SVJtZEJWRTlIMi94WVlDV0hsR1RNY3IyZVk1V2R5WGxzczRGOGtCUlByODlPM3c3blFkZjFWM1h6bVZVTzN3NFVMdTZ5YU1rUkNoOVcyVmZJNXlxd2lYNXlqbTVHSmgwK1FFTGFhS24xd1cwNkhMc080N0F4ODRkV0I1T3FlSDQ3SjhTN3crTm1ra2tEZm9xRjE1TFgyc21lZmhxY2FWaHJ6NVEvNVl0N3ZpN1IvcThBUmdZRHNjYmR6SElhOU5EU2g3cFRUU3hGeVpBSXdLU0NISTNDMjNuZ2k1Qk1aL0N1MmhRSm15NGlMRHhubzFtVi96aW0rSytrTGQvUDQ4TUtwVXZ2YWE1YzM1VzdsZ0h5cW5UckZsMjRhcEJDeU03UGtyaFhWTTFnMDl3Y2tJc2c4b0g1dTJlSTZWZ1FydURTZDRzWFI1UmpORXhoNm4wUEJsdWMwNlRFaG4zdTNFc2tnbHNxbk9DNTFMRzBGL0loY3RzMnJ5bnNCNWtEb21lQlJwOVd3ZkZkanFFMmR4c0NNYnNobTd6d3M5RTFYTzNaRVRDNENxWlJRS0pCd0kvMWlaZXRSWEZMT3N1ZmI1UDVGYlJsNjcrWnNONW9Jd3lvNUF4WUtneFNkWi9OcDBVQzZDMkJFZkZWbXFsUEVWTm5CdW5lWEE5OWxjclphbVcvQUJQVGJ2ekEzbm5vTG5HVktpVjd0bDVHMTA2TVNDbHI2NjlsWVk0bGZ0ZzZpOWFhdERoOFA3TVJ1cUJ1b21uVzIwTWcifQeyJkYXRhIjoiVTJGc2RHVmtYMS9Db0pEMVNJZjlPQ3pPRXFSNnpuUTNXYTI4cW4wSUhOQmF4cGFqMjBmYzhVNjlUVXJTRFN0JjUTJlalB2a2ZvYlk5Z1RYblVMTUc3QzlmWEZjNEwwQWRHSExGTHpCVmNQb21kQWqK042NHdJYWphdmhPektOMjRhTVlFcEE1YUJCU3gzbnVYdUNROHlMOUQ1WDdJeTlPZU03VHFmVncwVE92OUF4aHVGeDNVQ2svQW1FNmhpZmE0ZjFmNzc4V3o0NWtkR0Z4SGtvOGIzckowai9wSGpTVi91ZHFSTVhMZGZPeW1UL3cxeGtENmhXaG5Vcm9KaFNVRTQrbStJSk5nY0kyd2N6cjBYSVdVYWpjNS82QkJIUG1nMmJvbDM2aUJDbUVtdUdtdS9GSGpSbU5WRjZ2eDhCUW5MYkQvRXljK0RrWXZBbUNMNytRaW0zcHR0aS9aN3Z3cE1BMVZrbWtOdnVveGhNOUFqTHVhOWwwMEJqT1dXdmIyaTl2ZzVjMHEzcnRrY0hNTWNVUUZJYWluZVYvTW4zbjhYODdDRzNmdjdxNjU3SmJXbEE1bmVBMFovN3NIMWdtVlBZNWxUZVR3a01CWVp2MUJzNER1dVdUVzJiQ3YrTGl6bGpMdHZxOEhtUzBnT0lrdytkMkp4aHpkcm9TemxhdWtjSHJ5MUJHTUJHTDFkb1hxR3Q0TURPdDd4bllMbm9QN0hINWx3Z1hGaFk2TS9iRzNVcmswMld4TEptNWY2QXpXWFFUOXV4TEROMklyVG1JVWFid0x2eFUvQk01OFQ0dDlLSUhlWEpOR1N3NGRUQzhnK0JsVExxOXU0V3k1R3VEajI0QVVrYXRnWThBdEY3blhFQStpbWFwaWRxWGJmOG43T3RjNnVZeW5QTmJ1WW9VNytTaDlXeG1TSFFRWDRNMGovTkg2VDhjcDJOMXRBSlNpQVhkU3ZFM2R3cFVwbWR6c0ZUOTQ5YjhQQmROSTVqemU5SEpzU3ZPbFJ4eXNaNHpLU08zc3cwWVowK1BobW9HMHE4SkwyTEEzZzJGbmVGeDZ3dmNZWjhjNnZJOXY1eW5wNjJYeVhyVmMya0RYVVpkSlBLam1vZWIrTU5xaFoyRVZmVmphcmJ2c2ZSSjJpc2s3VmNvUGpwWFdpL09rMVVKTDk2SVJtZEJWRTlIMi94WVlDV0hsR1RNY3IyZVk1V2R5WGxzczRGOGtCUlByODlPM3c3blFkZjFWM1h6bVZVTzN3NFVMdTZ5YU1rUkNoOVcyVmZJNXlxd2lYNXlqbTVHSmgwK1FFTGFhS24xd1cwNkhMc080N0F4ODRkV0I1T3FlSDQ3SjhTN3crTm1ra2tEZm9xRjE1TFgyc21lZmhxY2FWaHJ6NVEvNVl0N3ZpN1IvcThBUmdZRHNjYmR6SElhOU5EU2g3cFRUU3hGeVpBSXdLU0NISTNDMjNuZ2k1Qk1aL0N1MmhRSm15NGlMRHhubzFtVi96aW0rSytrTGQvUDQ4TUtwVXZ2YWE1YzM1VzdsZ0h5cW5UckZsMjRhcEJDeU03UGtyaFhWTTFnMDl3Y2tJc2c4b0g1dTJlSTZWZ1FydURTZDRzWFI1UmpORXhoNm4wUEJsdWMwNlRFaG4zdTNFc2tnbHNxbk9DNTFMRzBGL0loY3RzMnJ5bnNCNWtEb21lQlJwOVd3ZkZkanFFMmR4c0NNYnNobTd6d3M5RTFYTzNaRVRDNENxWlJRS0pCd0kvMWlaZXRSWEZMT3N1ZmI1UDVGYlJsNjcrWnNONW9Jd3lvNUF4WUtneFNkWi9OcDBVQzZDMkJFZkZWbXFsUEVWTm5CdW5lWEE5OWxjclphbVcvQUJQVGJ2ekEzbm5vTG5HVktpVjd0bDVHMTA2TVNDbHI2NjlsWVk0bGZ0ZzZpOWFhdERoOFA3TVJ1cUJ1b21uVzIwTWcifQ==",
    "status": 2,
    "provider": 1,
    "providerDescription": "Provedor",
    "message": "Gerado link para a Tokenização",
    "dateAdd": "2022-09-27T19:15:29.303948",
    "isActive": false
}


Acessar o link informado no campo checkoutPageLink, em seguida realize o preenchimento dos campos e clique em "Guardar Cartão"

Com o Id do Customers e Id do Payment-Token armazenados, será possivel realizar a subscrição com o cartão tokenizado, segue procedimento para os campos que serão atualizados:

Maiores duvidas sobre a Subscrição, acesse.

POST api/v1/Subscriptions

customerId - informar o id customers;

  • "customerId": "429203e1-3261-45a7-b83c-9eb78deb9fca"

paymentTokenId - id Payment-Token;

  • "paymentTokenId": "e5ceab4d-f0d9-484b-a6cb-d3b8ee8ca639"


Aviso
titleDocumentação

Para uma listagem completa da saída por favor verifique a documentação Swagger.

Acesso a tela: API Subscrição com dados de pagamento.