--- updatedAt: 2026-04-06T17:26:34.000Z agentTools: projectIndex: https://docs.pagar.me/v3/llms.txt --- # Criando um cartão Você pode armazenar os dados do cartão do seu cliente através da rota /cards, assim você poderá usar o id do objeto gerado para realizar futuras transações, no lugar do card_hash. > 👍 One Click Buy > > Essa é a melhor forma de implementar One Click Buy no seu site. Com o card\_id em nosso servidor, o seu cliente não precisará digitar os dados do cartão novamente e conseguirá comprar com apenas um clique. Sensacional né? # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "api-settings", "version": "3" }, "servers": [ { "url": "https://api.pagar.me/1" } ], "components": { "securitySchemes": { "sec0": { "x-default": "", "type": "apiKey", "name": "api_key", "in": "query" } } }, "security": [ { "sec0": [] } ], "paths": { "/cards": { "post": { "summary": "Criando um cartão", "description": "Você pode armazenar os dados do cartão do seu cliente através da rota /cards, assim você poderá usar o id do objeto gerado para realizar futuras transações, no lugar do card_hash.", "operationId": "criando-um-cartao", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "card_number", "card_expiration_date", "card_holder_name", "card_hash" ], "properties": { "card_number": { "type": "string", "description": "Número do cartão", "default": "!CARD_NUMBER!" }, "card_expiration_date": { "type": "string", "description": "Data de expiração do cartão", "default": "!CARD_EXPIRATION_DATE!" }, "card_holder_name": { "type": "string", "description": "Nome no cartão do portador", "default": "!NAME!" }, "card_cvv": { "type": "string", "description": "Código de segurança do cartão", "default": "!CARD_CVV!" }, "customer_id": { "type": "string", "description": "Informações do cliente do card a ser gerado" }, "card_hash": { "type": "string", "description": "Dados criptografados do cartão" } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"object\": \"card\",\n \"id\": \"card_cj428xxsx01dt3f6dvre6belx\",\n \"date_created\": \"2017-06-18T05:03:19.907Z\",\n \"date_updated\": \"2017-06-18T05:03:20.318Z\",\n \"brand\": \"visa\",\n \"holder_name\": \"Aardvark Silva\",\n \"first_digits\": \"401872\",\n \"last_digits\": \"8048\",\n \"country\": \"RU\",\n \"fingerprint\": \"TaApkY+9emV9\",\n \"customer\": null,\n \"valid\": true,\n \"expiration_date\": \"1122\"\n}" } }, "schema": { "type": "object", "properties": { "object": { "type": "string", "example": "card" }, "id": { "type": "string", "example": "card_cj428xxsx01dt3f6dvre6belx" }, "date_created": { "type": "string", "example": "2017-06-18T05:03:19.907Z" }, "date_updated": { "type": "string", "example": "2017-06-18T05:03:20.318Z" }, "brand": { "type": "string", "example": "visa" }, "holder_name": { "type": "string", "example": "Aardvark Silva" }, "first_digits": { "type": "string", "example": "401872" }, "last_digits": { "type": "string", "example": "8048" }, "country": { "type": "string", "example": "RU" }, "fingerprint": { "type": "string", "example": "TaApkY+9emV9" }, "customer": {}, "valid": { "type": "boolean", "example": true, "default": true }, "expiration_date": { "type": "string", "example": "1122" } } } } } } }, "deprecated": false, "x-readme": { "code-samples": [ { "language": "curl", "code": "curl -X POST https://api.pagar.me/1/cards -H 'content-type: application/json' -d '{\n \"api_key\": \"SUA_API_KEY\", \n \"card_expiration_date\": \"1122\", \n \"card_number\": \"4018720572598048\",\n \"card_cvv\": \"123\", \n \"card_holder_name\": \"Aardvark Silva\"\n}'" }, { "language": "ruby", "code": "require 'pagarme'\n\nPagarMe.api_key = \"ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0\"\n\n\ncard = PagarMe::Card.new({\n\t:card_number => '4018720572598048',\n :card_holder_name => 'Aardvark Silva',\n\t:card_expiration_month => '11',\n\t:card_expiration_year => '22',\n\t:card_cvv => '123'\n})\n\ncard.create\n" }, { "language": "php", "code": "cards()->create([\n 'holder_name' => 'Yoda',\n 'number' => '4242424242424242',\n 'expiration_date' => '1225',\n 'cvv' => '123'\n]);" }, { "language": "csharp", "code": "PagarMeService.DefaultApiKey = \"SUA_API_KEY\";\n\nCard card = new Card();\ncard.Number = \"4018720572598048\";\ncard.HolderName = \"Aardvark Silva\";\ncard.ExpirationDate = \"1122\";\ncard.Cvv = \"123\";\n\ncard.Save();\n" }, { "language": "java", "code": "import java.util.Collection;\n\nimport me.pagar.model.Card;\nimport me.pagar.model.PagarMe;\nimport me.pagar.model.PagarMeException;\n\nPagarMe.init(\"SUA_API_KEY\");\n\nCard card = new Card();\ncard.setNumber(\"4018720572598048\");\ncard.setHolderName(\"Aardvark Silva\");\ncard.setExpiresAt(\"1122\");\ncard.setCvv(\"123\");\ncard.save();" }, { "language": "javascript", "code": "const pagarme = require('pagarme')\n\npagarme.client.connect({ api_key: 'SUA_API_KEY' })\n .then(client => client.cards.create({\n card_number: '4018720572598048',\n card_holder_name: 'Aardvark Silva',\n card_expiration_date: '1122',\n card_cvv: '123',\n }))\n .then(card => console.log(card.id))", "name": "JS" }, { "language": "python", "code": "import pagarme\n\npagarme.authentication_key('SUA_API_KEY')\n\ncard_data = {\n \"card_expiration_date\": \"1122\",\n \"card_number\": \"4018720572598048\",\n \"card_cvv\": \"123\",\n \"card_holder_name\": \"Cersei Lannister\"\n}\n\nprint (pagarme.card.create(card_data))" } ], "samples-languages": [ "curl", "ruby", "php", "csharp", "java", "javascript", "python" ] } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```