{"id":1622,"date":"2018-07-12T15:33:28","date_gmt":"2018-07-12T18:33:28","guid":{"rendered":"http:\/\/maxipago.com\/developers\/?page_id=1622"},"modified":"2024-01-31T18:33:43","modified_gmt":"2024-01-31T21:33:43","slug":"salvar-um-cartao-na-base","status":"publish","type":"page","link":"https:\/\/www.maxipago.com\/developers\/apidocs\/requisicoes-de-cadastro\/salvar-um-cartao-na-base\/","title":{"rendered":"Salvar Cart\u00f5es na Base – Tokeniza\u00e7\u00e3o"},"content":{"rendered":"
\n
\n

O nosso gateway permite ao estabelecimento salvar o cart\u00e3o de cr\u00e9dito do cliente para futuras compras, conhecido com “one click buy<\/em>“. O n\u00famero de cart\u00e3o e a data de vencimento ficam guardados em nossos servidores e o estabelecimento recebe um token \u00fanico referente ao cart\u00e3o.<\/p>\n

Em uma futura compra, ao inv\u00e9s de pedir novamente o n\u00famero do cart\u00e3o ao cliente, o estabelecimento envia o token para a maxiPago!, agilizando o checkout.<\/p>\n

Por medidas de seguran\u00e7a \u00e9 preciso enviar os dados de cobran\u00e7a do portador, ou seja, o endere\u00e7o onde o cliente do cart\u00e3o recebe a fatura.<\/p>\n<\/div>\n

\n

URLs para salvar um cart\u00e3o na base<\/strong><\/h2>\n

Sandbox:<\/strong>\u00a0https:\/\/testapi.maxipago.net\/UniversalAPI\/postAPI
\nProdu\u00e7\u00e3o:<\/strong>\u00a0https:\/\/api.maxipago.net\/UniversalAPI\/postAPI<\/p>\n<\/div>\n<\/div>\n

\n
\n

Exemplo de requisi\u00e7\u00e3o<\/strong><\/h2>\n
<api-request>\n    <verification>\n        <merchantId>store-id<\/merchantId>\n        <merchantKey>store-key<\/merchantKey>\n    <\/verification>\n    <command>add-card-onfile<\/command>\n    <request>\n        <customerId>999<\/customerId>\n        <creditCardNumber>4111111111111111<\/creditCardNumber>\n        <expirationMonth>12<\/expirationMonth>\n        <expirationYear>2030<\/expirationYear>\n        <billingName>Fulano de tal<\/billingName>\n        <billingAddress1>Av. Marcos Penteado de Ulhoa Rodrigues, 939<\/billingAddress1>\n        <billingAddress2>11 Andar<\/billingAddress2>\n        <billingCity>Barueri<\/billingCity>\n        <billingState>SP<\/billingState>\n        <billingZip>06360040<\/billingZip>\n        <billingCountry>BR<\/billingCountry>\n        <billingPhone>01121218536<\/billingPhone>\n        <billingEmail>fulano@dominio.com<\/billingEmail>\n        <onFilePermissions>ongoing<\/onFilePermissions>\n        <onFileMaxChargeAmount>999.00<\/onFileMaxChargeAmount>\n    <\/request>\n<\/api-request><\/pre>\n<\/div>\n
\n
Retorno em caso de sucesso<\/strong><\/h2>\n
<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\n<api-response>\n    <errorCode>0<\/errorCode>\n    <errorMessage><\/errorMessage>\n    <command>add-card-onfile<\/command>\n    <time>1678288886147<\/time>\n    <result>\n        <token>+Nz2WhppW\/KCcvt1DHogeQ==<\/token>\n    <\/result>\n<\/api-response><\/pre>\n
Importante<\/strong>: Reserve o valor informado no campo: <token><\/strong>, ele ser\u00e1 usado no futuro.<\/p>\n
Retorno em caso de erro<\/strong><\/h2>\n
<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\n<api-response>\n    <errorCode>1<\/errorCode>\n    <errorMessage>\n        <![CDATA[Parser Error: URI=null Line=1: cvc-length-valid: Value '30' with length = '2' is not facet-valid with respect to length '4' for type '#AnonType_expirationYear'.]]>\n    <\/errorMessage>\n    <time>1678289027065<\/time>\n<\/api-response><\/pre>\n
Os par\u00e2metros aceitos no add-card-onfile<\/strong><\/h2>\n
Os par\u00e2metros aceitos no comando add-card-onfile est\u00e3o abaixo. Se o campo for vazio, n\u00e3o enviar.<\/p>\n
\n                \n                \n                            \n                            \n                            \n                    <\/colgroup>\n            <\/table>\n