> ## Documentation Index
> Fetch the complete documentation index at: https://docs.3xpay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout Transparente

> Cria uma nova transação de checkout transparente



## OpenAPI

````yaml POST /transaction
openapi: 3.0.1
info:
  title: 3X Pay Gateway
  description: >-
    Para autenticar as rotas dessa API são necessario ter em mãos a
    **api_secret** e **api_key** da sua conta. Este podem ser encontrados dentro
    do painel https://app.3xpay.co acessando a página de Configurações e
    clicando na opção de Credencias de API.
  version: 1.0.0
servers:
  - url: https://gateway.3xpay.co
security:
  - apiKeyAuth: []
    apiSecretAuth: []
tags:
  - name: Transações
    description: Operações relacionadas a transações financeiras
  - name: Webhooks
    description: Notificações de eventos da API
  - name: Balance
    description: Operações relacionadas ao saldo da conta
  - name: Sub-accounts
    description: Operações relacionadas a subcontas BaaS
  - name: MED Contest
    description: >-
      Endpoints server-to-server para responder a solicitações de MED (Mecanismo
      Especial de Devolução do Pix)
paths:
  /transaction:
    post:
      tags:
        - Transações
      summary: Checkout Transparente
      description: Cria uma nova transação de checkout transparente
      operationId: createCheckout
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckoutRequest'
      responses:
        '201':
          description: Transação criada com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutResponse'
components:
  schemas:
    CheckoutRequest:
      type: object
      required:
        - transaction
      properties:
        transaction:
          type: object
          required:
            - customer_infos
            - address
            - payment_method
            - callback_url
            - products
          properties:
            customer_infos:
              type: object
              required:
                - name
                - email
                - document
                - phone
              properties:
                name:
                  type: string
                  description: Nome do cliente
                email:
                  type: string
                  description: Email do cliente
                document:
                  type: string
                  description: CPF/CNPJ do cliente
                phone:
                  type: string
                  description: Telefone do cliente
            address:
              type: object
              required:
                - zipcode
                - street
                - number
                - district
                - city
                - state
              properties:
                zipcode:
                  type: string
                  description: CEP
                street:
                  type: string
                  description: Rua
                number:
                  type: string
                  description: Número
                district:
                  type: string
                  description: Bairro
                adjunct:
                  type: string
                  description: Complemento
                city:
                  type: string
                  description: Cidade
                state:
                  type: string
                  description: Estado
            payment_method:
              type: string
              description: Método de pagamento
              enum:
                - PIX
                - CREDIT_CARD
                - BILLET
            installments:
              type: integer
              description: Número de parcelas
            card_payment_method_id:
              type: string
              description: Bandeira do cartão
            card_number:
              type: string
              description: Número do cartão
            expiration_date:
              type: string
              description: Data de expiração do cartão
              pattern: ^(0[1-9]|1[0-2])/([0-9]{2})$
            cvv:
              type: string
              description: Código de segurança do cartão
            holder_name:
              type: string
              description: Nome do titular do cartão
            callback_url:
              type: string
              description: URL para callback
            products:
              type: array
              items:
                type: object
                required:
                  - name
                  - price
                  - quantity
                properties:
                  name:
                    type: string
                    description: Nome do produto
                  price:
                    type: number
                    description: Preço do produto
                  quantity:
                    type: integer
                    description: Quantidade do produto
    CheckoutResponse:
      type: object
      properties:
        status:
          type: string
          description: Status da transação
          example: success
        payment:
          type: object
          properties:
            status:
              type: string
              description: Status do pagamento
              example: PROCESSING
            transaction_id:
              type: string
              description: ID da transação
              example: ScEEPm9jzOgL1FbU2J673JDaNMqMV7S
            payment_code:
              type: string
              description: Código de pagamento PIX
            link:
              type: string
              description: Link para pagamento
            due_date:
              type: string
              description: Data de vencimento
              format: date-time
            total:
              type: number
              description: Valor total da transação
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: api_key
    apiSecretAuth:
      type: apiKey
      in: header
      name: api_secret

````