> ## Documentation Index > Fetch the complete documentation index at: https://docs.purincash.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Card Payment > Cria um pagamento no cartão de crédito via Stripe Checkout e retorna a checkoutUrl para redirecionar o cliente. A sessão de checkout expira em 30 minutos. Não disponível no modo sandbox (chaves ps_test_). ## OpenAPI ````yaml /api-reference/openapi.yaml post /v1/card-payments openapi: 3.1.0 info: title: PurinCash API version: 1.0.0 servers: - url: https://api.purincash.com description: Produção security: - bearerAuth: [] tags: - name: Cartao description: Pagamentos no cartao de credito. - name: Cobrancas description: Cobrancas PIX avulsas com valor livre. - name: Entregas description: Conteudo entregue automaticamente apos o pagamento. - name: Disputas description: Contestacoes (MED) e envio de evidencias. - name: Pagamentos description: Pagamentos PIX e LTC vinculados ou nao a um produto. - name: Saques description: Saques em PIX, LTC e USDT. - name: Produtos description: Produtos de cobranca criados pela API. - name: Sandbox description: Simulacao de pagamentos e saldo de teste. - name: Splits description: Cobrancas divididas entre varias contas. - name: Loja description: Produtos da loja do Discord (somente leitura). - name: Assinaturas description: PIX recorrente. - name: Carteira description: Saldo, retencoes e valores a liberar. paths: /v1/card-payments: post: tags: - Cartao summary: Create Card Payment description: >- Cria um pagamento no cartão de crédito via Stripe Checkout e retorna a checkoutUrl para redirecionar o cliente. A sessão de checkout expira em 30 minutos. Não disponível no modo sandbox (chaves ps_test_). operationId: createCardPayment requestBody: required: true content: application/json: schema: type: object required: - valueCents properties: valueCents: type: integer minimum: 80 description: Valor do pagamento em centavos. Mínimo de 80 (R$ 0,80). description: type: string maxLength: 200 default: Pagamento Cartao description: >- Descrição exibida no checkout do Stripe. Máximo de 200 caracteres. callbackUrl: type: string format: uri maxLength: 500 description: >- URL HTTPS pública para receber o webhook de confirmação do pagamento. Máximo de 500 caracteres. customer: type: object description: Dados do cliente (opcional). properties: name: type: string maxLength: 100 description: Nome do cliente. Máximo de 100 caracteres. email: type: string maxLength: 255 description: >- E-mail do cliente, pré-preenchido no checkout do Stripe. Máximo de 255 caracteres. externalId: type: string maxLength: 200 description: >- Identificador do cliente no seu sistema. Máximo de 200 caracteres. metadata: type: string maxLength: 2048 default: '{}' description: String JSON com dados livres. Máximo de 2048 caracteres. successUrl: type: string format: uri maxLength: 500 description: >- URL de redirecionamento após o pagamento aprovado. Máximo de 500 caracteres. cancelUrl: type: string format: uri maxLength: 500 description: >- URL de redirecionamento se o cliente cancelar o checkout. Máximo de 500 caracteres. example: valueCents: 4990 description: Plano Premium callbackUrl: https://minhaloja.com/webhooks/purincash customer: name: João Silva email: joao@email.com externalId: user_123 metadata: '{"pedido":"123"}' successUrl: https://minhaloja.com/sucesso cancelUrl: https://minhaloja.com/cancelado responses: '201': description: Pagamento no cartão criado com sucesso. content: application/json: schema: type: object properties: orderCode: type: string description: Código único do pedido. Use-o para consultar o pagamento. status: type: string enum: - pending - paid - expired - refunded - failed description: Status do pagamento. Sempre "pending" na criação. amountCents: type: integer description: Valor solicitado em centavos. currency: type: string description: Moeda do pagamento. Sempre "BRL". checkoutUrl: type: string description: >- URL do Stripe Checkout para onde o cliente deve ser redirecionado para pagar. expiresAt: type: string format: date-time description: >- Data e hora de expiração da sessão de checkout (30 minutos após a criação). example: orderCode: JUE7Y9MPSX status: pending amountCents: 4990 currency: BRL checkoutUrl: https://checkout.stripe.com/... expiresAt: '2026-03-18T12:30:00.000Z' '400': description: >- Parâmetro inválido ou ausente (ex. valueCents menor que 80, callbackUrl inválida) ou chave de sandbox usada neste endpoint. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: valueCents must be >= 80 (R$ 0.80) '401': description: Chave de API inválida, ausente ou revogada. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Loja não verificada. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: Pagamentos no cartão não configurados (Stripe indisponível). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Card payments not configured (Stripe) components: schemas: Error: type: object properties: error: type: string description: >- Mensagem de erro legivel. Trate pelo codigo HTTP; o texto pode mudar. securitySchemes: bearerAuth: type: http scheme: bearer description: Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_). ````