---
updatedAt: 2026-08-25T10:07:22.000Z
agentTools:
  projectIndex: https://developers.international.pagseguro.com/llms.txt
---

# Create a Transaction

Creates a new transaction. You can use this endpoint to create payments when using:
- Raw credit card (only available for PCI merchants)
- Credit card token
- Card on File token (Token stored by PagSeguro)
- Google Pay
- Pix
- PSE Avanza
- Nequi

For the accepted document types and validation rules per country, see [Document Validation](ref:document-validation).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "PagSeguro International API",
    "description": "",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.sandbox.international.pagseguro.com",
      "description": "Sandbox Server"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Basic Authentication using merchant_id and secret_key.\nAuthorization header must contain the word **Basic** followed by a **space** and a **base64-encoded string** with **merchant_id:secret_key**.\nFor example: `Authorization: Basic MTIzNDozN2IzNmUxNy1lZGIyLTRkNjAtOWFmZC05MTA2MmJlYmY1ZTQ=`\n"
      }
    },
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "description": "Error message."
                },
                "location": {
                  "type": "string",
                  "description": "Location of the error."
                }
              }
            }
          }
        },
        "description": "Schema for error responses."
      },
      "DomainErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "description": "Domain error message."
          }
        },
        "description": "Schema for domain error responses."
      },
      "RedirectUrls": {
        "type": "object",
        "description": "URLs to redirect the buyer after the transaction is finished.",
        "properties": {
          "success": {
            "type": "string",
            "description": "URL used to redirect users after successfully completing the checkout process.",
            "format": "url",
            "maxLength": 200
          },
          "failure": {
            "type": "string",
            "description": "URL used to redirect users after failing to complete the checkout process.",
            "format": "url",
            "maxLength": 200
          }
        },
        "required": [
          "success",
          "failure"
        ]
      },
      "Integration": {
        "type": "object",
        "description": "Object containing the integration data referring to the Merchant Store.",
        "properties": {
          "reference": {
            "type": "string",
            "description": "Transaction reference code in the merchant's store.",
            "minLength": 4,
            "maxLength": 64,
            "pattern": "^[A-Za-z0-9-_]+$"
          },
          "notification_url": {
            "type": "string",
            "description": "PagSeguro uses the URL to send notifications after the transaction status changes.",
            "format": "url",
            "maxLength": 200
          },
          "language": {
            "type": "string",
            "description": "Language used when communicating with buyers.\n- `en_US`: English - United States\n- `es_ES`: Spanish - Spain\n- `pt_BR`: Portuguese - Brazil\n- `pt_PT`: Portuguese - Portugal\n- `tr_TR`: Turkish - Turkey\n",
            "enum": [
              "en_US",
              "es_ES",
              "pt_BR",
              "pt_PT",
              "tr_TR"
            ]
          },
          "redirect_urls": {
            "$ref": "#/components/schemas/RedirectUrls",
            "description": "Required for e-wallet transactions (e.g., PayPal)."
          }
        },
        "required": [
          "reference",
          "notification_url",
          "language"
        ]
      },
      "Charge": {
        "type": "object",
        "description": "Object containing the payment details required to generate the transaction.",
        "properties": {
          "country": {
            "type": "string",
            "description": "The country where the transaction originates, represented by a two-letter ISO 3166-1 alpha-2 code.",
            "pattern": "^[A-Z]{2}$"
          },
          "method": {
            "type": "string",
            "description": "Required for payments using e-Wallet. It defines the payment method used for the transaction. \n",
            "enum": [
              "NIUBIZ_WALLET",
              "PIX"
            ]
          },
          "installments": {
            "type": "integer",
            "description": "If the payment is processed in installments, specify the total number of monthly installments selected by the customer.",
            "example": 6
          },
          "type": {
            "type": "string",
            "description": "Specifies the type of payment method used for the transaction.\n\n- Required for transactions that **do not** use an e-Wallet. \n- Not applicable for e-Wallet payments, since in that case the payment method is determined by the `method` parameter.",
            "enum": [
              "CREDIT_CARD",
              "DEBIT_CARD",
              "EFT",
              "OBT",
              "POSTPAY",
              "PREPAY"
            ]
          },
          "initiated_by": {
            "type": "string",
            "description": "Indicates who initiated the transaction. If the transaction was initiated by the customer interaction, use `CUSTOMER` (CIT - Customer Initiated Transaction). If the transaction was initiated by the merchant without direct customer interaction, use `MERCHANT` (Merchant Initiated Transaction).\n",
            "enum": [
              "CUSTOMER",
              "MERCHANT"
            ]
          },
          "credit_card": {
            "description": "Credit card details. This object is required for transactions that do not use an e-Wallet.\n",
            "oneOf": [
              {
                "$ref": "#/components/schemas/ChargeCreditCardRaw"
              },
              {
                "$ref": "#/components/schemas/ChargeCreditCardToken"
              },
              {
                "$ref": "#/components/schemas/ChargeCardOnFileToken"
              },
              {
                "$ref": "#/components/schemas/ChargeCreditCardGooglePay"
              }
            ]
          },
          "authentication_method": {
            "$ref": "#/components/schemas/AuthenticationMethod",
            "description": "Contains 3D Secure authentication details for the credit card transaction."
          }
        },
        "required": [
          "country"
        ]
      },
      "TransactionRequest": {
        "type": "object",
        "description": "Request body for creating a transaction.",
        "properties": {
          "integration": {
            "description": "Object containing the integration data referring to the Merchant Store.",
            "$ref": "#/components/schemas/Integration"
          },
          "order": {
            "description": "Contains the list of products purchased by the customer from the merchant's store along with their respective values.",
            "$ref": "#/components/schemas/Order"
          },
          "charge": {
            "description": "Object containing the payment details required to generate the transaction.",
            "$ref": "#/components/schemas/Charge"
          },
          "payer": {
            "description": "Contains information about the Customer who made the purchase on the Merchant.",
            "$ref": "#/components/schemas/Payer"
          }
        },
        "required": [
          "integration",
          "order",
          "charge",
          "payer"
        ]
      },
      "Order": {
        "type": "object",
        "description": "Contains the list of products purchased by the customer from the merchant's store along with their respective values.",
        "properties": {
          "currency": {
            "type": "string",
            "description": "Currency for charging the transaction (ISO 4217).\n\nList of currencies available for PagSeguro:\n\n| ISO Code | Currency                |\n|----------|-------------------------|\n| BRL      | Brazilian Real (Brazil) |\n| CLP      | Chilean Peso (Chile)    |\n| COP      | Colombian Peso (Colombia) |\n| MXN      | Mexican Peso (Mexico)   |\n| PEN      | Nuevo Sol (Peru)        |\n| USD      | Dollar (USA)            |\n",
            "pattern": "^[A-Z]{3}$",
            "enum": [
              "BRL",
              "CLP",
              "COP",
              "MXN",
              "PEN",
              "USD"
            ]
          },
          "items": {
            "type": "array",
            "description": "List of items purchased by the customer.",
            "minItems": 1,
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "quantity": {
                  "type": "integer",
                  "description": "Number of items selected by the customer.",
                  "minimum": 1
                },
                "description": {
                  "type": "string",
                  "description": "Item description. Accepted characters: Uppercase (A-Z), lowercase (a-z), and numbers (0-9).\n",
                  "minLength": 1,
                  "maxLength": 180,
                  "pattern": "^[A-Za-z0-9]+$"
                },
                "unit_price": {
                  "type": "number",
                  "format": "float",
                  "description": "Price per unit.\n\nThe PagSeguro API supports amounts starting from 0.01. However, the minimum and maximum transaction limits vary by country and payment method. We recommend using the values listed below:\n\n| Country  | Payment Method         | Minimum Total Amount | Maximum Total Amount | ISO Code Currency | Accepted Brands                                            |\n|----------|------------------------|----------------------|----------------------|-------------------|------------------------------------------------------------|\n| Brazil   | All credit card brands | 1.00                 | 40000.00             | BRL               | American Express, Diners, MasterCard, Visa, Elo, Hipercard |\n| Chile    | All credit card brands | 0.01                 | 1000000.00           | CLP               | American Express, Diners, MasterCard, Visa                 |\n| Colombia | All credit card brands | 0.01                 | 38000000.00          | COP               | American Express, Diners, MasterCard, Visa                 |\n| Mexico   | All credit card brands | 0.01                 | 74000.00             | MXN               | American Express, Diners, MasterCard, Visa                 |\n| Peru     | All credit card brands | 0.01                 | 34000.00             | PEN               | American Express, Diners, MasterCard, Visa                 |\n",
                  "minimum": 0.01
                }
              },
              "required": [
                "quantity",
                "description",
                "unit_price"
              ]
            }
          }
        },
        "required": [
          "currency",
          "items"
        ]
      },
      "Store": {
        "type": "boolean",
        "description": "Indicates whether to store the credit card information for future transactions. \n\nUse this option if you want to save the card details for subsequent purchases. This option is related to the Card on File feature.\n\nThe default value is `false`."
      },
      "HolderName": {
        "type": "string",
        "description": "The cardholder's name on the credit card. Must be between 2 and 26 characters.  Only letters (A-Z, a-z) and special characters (,.'-) are allowed.  Spaces are not allowed at the beginning or end.  Words must be separated by exactly one space.\n",
        "minLength": 2,
        "maxLength": 26,
        "pattern": "^(?! )[A-Za-z.,'-]+( [A-Za-z.,'-]+)*(?<! )$"
      },
      "ChargeCreditCardRaw": {
        "type": "object",
        "description": "Credit card details when using raw card information. This object is required when using the raw credit card option.",
        "properties": {
          "raw": {
            "type": "object",
            "properties": {
              "number": {
                "type": "string",
                "description": "The card number.",
                "pattern": "^[0-9]{12,19}$",
                "minLength": 12,
                "maxLength": 19
              },
              "cvc": {
                "type": "string",
                "description": "The card security code (CSV).",
                "pattern": "^[0-9]{3,4}$",
                "minLength": 3,
                "maxLength": 4
              },
              "expiration_month": {
                "type": "string",
                "description": "This parameter is required. Credit card expiration month.",
                "enum": [
                  "01",
                  "02",
                  "03",
                  "04",
                  "05",
                  "06",
                  "07",
                  "08",
                  "09",
                  "10",
                  "11",
                  "12"
                ]
              },
              "expiration_year": {
                "type": "string",
                "description": "Credit card expiration year.",
                "pattern": "^[0-9]{4}$"
              }
            },
            "required": [
              "number",
              "cvc",
              "expiration_month",
              "expiration_year"
            ]
          },
          "holder_name": {
            "$ref": "#/components/schemas/HolderName"
          },
          "store": {
            "$ref": "#/components/schemas/Store"
          }
        },
        "required": [
          "raw",
          "holder_name"
        ]
      },
      "ChargeCardOnFileToken": {
        "type": "object",
        "description": "Credit card details when using a Card on File token (Token stored by PagSeguro). This object is required when using the Card on File token option.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Card on File token generated by PagSeguro.",
            "example": "3e233f49-04d0-40ee-ae13-984e2b7988a4",
            "minLength": 36,
            "maxLength": 36
          },
          "cvv": {
            "type": "string",
            "description": "The card security code.",
            "pattern": "^[0-9]{3,4}$",
            "minLength": 3,
            "maxLength": 4
          }
        },
        "required": [
          "id"
        ]
      },
      "ChargeCreditCardToken": {
        "type": "object",
        "description": "Credit card details when using a token credit card generated in the frontend. \n\nThe `store` parameter is required when using the token credit card option.",
        "properties": {
          "token": {
            "type": "string",
            "description": "Credit card token generated by PagSeguro's JS."
          },
          "holder_name": {
            "$ref": "#/components/schemas/HolderName"
          },
          "store": {
            "$ref": "#/components/schemas/Store"
          }
        },
        "required": [
          "token",
          "holder_name"
        ]
      },
      "ChargeCreditCardGooglePay": {
        "type": "object",
        "description": "Credit card details when using Google Pay. This object is required when using the Google Pay option.",
        "properties": {
          "google_pay": {
            "type": "object",
            "properties": {
              "token": {
                "type": "string",
                "description": "The token returned by Google Pay."
              }
            },
            "required": [
              "token"
            ]
          },
          "holder_name": {
            "$ref": "#/components/schemas/HolderName"
          }
        },
        "required": [
          "google_pay",
          "holder_name"
        ]
      },
      "Payer": {
        "type": "object",
        "description": "Contains information about the Customer who made the purchase on the Merchant. \n",
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 60,
            "description": "Payer E-mail used to execute the order."
          },
          "ip": {
            "type": "string",
            "description": "Payer IP used to execute the order. Accepts IPv4 or IPv6."
          },
          "person": {
            "$ref": "#/components/schemas/PayerPerson"
          }
        },
        "required": [
          "email",
          "ip",
          "person"
        ]
      },
      "PayerPerson": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The payer's full name. Must be between 4 and 50 characters long and contain at least two words.  The first word must have at least 2 characters, while middle and last names can have between 1 and 40 characters.  Words must be separated by exactly one space.  Accepted characters: uppercase and lowercase letters (A-Z, a-z), special characters (àáâäãåąčćęèéêëėįìíîïłńòóôöõøùúûüųūÿýżźñçčšžÀÁÂÄÃÅĄĆČĖĘÈÉÊËÌÍÎÏĮŁŃÒÓÔÖÕØÙÚÛÜŲŪŸÝŻŹÑßÇŒÆČŠŽ∂ð/,.'&-).  Leading and trailing spaces are not allowed.\n",
            "minLength": 4,
            "maxLength": 50,
            "pattern": "^(?! )[A-Za-zÀ-ÖØ-öø-ÿßÇŒÆČŠŽ∂ð/,.'&-]{2,}(?: [A-Za-zÀ-ÖØ-öø-ÿßÇŒÆČŠŽ∂ð/,.'&-]{1,40})+(?<! )$"
          },
          "birth_date": {
            "type": "string",
            "format": "date",
            "description": "Payer's birth date in YYYY-MM-DD format.",
            "pattern": "^(19[0-9]{2}|20[0-9]{2})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$"
          },
          "document": {
            "description": "Contains the payer's identification document details for the transaction. TODO - add link to the Document validation page.",
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "Document type.",
                "minLength": 2,
                "maxLength": 4
              },
              "number": {
                "type": "string",
                "description": "Document number.",
                "minLength": 7,
                "maxLength": 18
              }
            },
            "required": [
              "type",
              "number"
            ]
          },
          "phone": {
            "type": "object",
            "description": "Contains the payer's phone information.",
            "properties": {
              "country_code": {
                "type": "string",
                "description": "Phone country code.",
                "minLength": 1,
                "maxLength": 3,
                "pattern": "^[0-9]{1,3}$"
              },
              "number": {
                "type": "string",
                "description": "Phone number.",
                "minLength": 1,
                "maxLength": 11,
                "pattern": "^[0-9]{1,11}$"
              }
            },
            "required": [
              "country_code",
              "number"
            ]
          }
        },
        "required": [
          "name",
          "document",
          "phone"
        ],
        "description": "Payer's personal information."
      },
      "Redirect": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The URL to which the buyer should be redirected to complete the payment.",
            "format": "url"
          }
        }
      },
      "PaymentInstructions": {
        "type": "object",
        "description": "Contains payment instructions for the buyer, such as a redirect URL or QR code for completing the payment.",
        "properties": {
          "interaction_type": {
            "type": "array",
            "description": "Indicates the type of interaction required from the buyer to complete the payment.",
            "items": {
              "type": "string",
              "enum": [
                "REDIRECT",
                "CODE"
              ]
            }
          },
          "redirect": {
            "description": "Contains the URL to which the buyer should be redirected to complete the payment.",
            "$ref": "#/components/schemas/Redirect"
          },
          "type": {
            "type": "string",
            "description": "The type of code presented to the buyer.",
            "enum": [
              "QR_CODE"
            ]
          },
          "value": {
            "type": "string",
            "description": "The raw code value to be used or displayed to the buyer."
          },
          "image": {
            "type": "string",
            "format": "url",
            "description": "URL of the QR code image."
          }
        }
      },
      "TransactionResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Transaction UUID code.",
            "format": "uuid"
          },
          "reference": {
            "type": "string",
            "description": "Transaction reference code in the merchant's store."
          },
          "status": {
            "type": "string",
            "description": "Status of the created transaction."
          },
          "amount": {
            "type": "number",
            "format": "float",
            "description": "The amount charged for the transaction."
          },
          "installments": {
            "type": "number",
            "description": "The number of installments of the transaction."
          },
          "currency": {
            "type": "string",
            "description": "The currency used for billing."
          },
          "country": {
            "type": "string",
            "description": "The country of origin informed in the transaction."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Transaction creation date in Coordinated Universal Time (UTC)."
          },
          "payment_instructions": {
            "$ref": "#/components/schemas/PaymentInstructions"
          }
        },
        "description": "Response for a successful transaction creation."
      },
      "AuthenticationMethod": {
        "type": "object",
        "description": "Contains 3D Secure authentication details for the credit card transaction.\n",
        "properties": {
          "type": {
            "type": "string",
            "description": "Type of authentication method used. Currently only `3DS` is supported.",
            "example": "3DS"
          },
          "cavv": {
            "type": "string",
            "description": "Cardholder Authentication Verification Value (CAVV).",
            "example": "BwABBylVaQAAAAFwllVpAAAAAAA="
          },
          "xid": {
            "type": "string",
            "description": "Transaction Identifier used in 3D Secure (optional in 3DS 2.x).",
            "example": "BwABBylVaQAAAAFwllVpAAAAAAA="
          },
          "eci": {
            "type": "string",
            "description": "Electronic Commerce Indicator. Indicates the result of the authentication.",
            "example": "05"
          },
          "version": {
            "type": "string",
            "description": "3D Secure protocol version used for the authentication.",
            "example": "2.1.0"
          },
          "dstrans_id": {
            "type": "string",
            "description": "Directory Server Transaction ID (DSTransID), used in 3D Secure 2.x.",
            "example": "DIR_SERVER_TID"
          }
        },
        "required": [
          "type",
          "cavv",
          "eci",
          "version",
          "dstrans_id"
        ]
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request - The request was malformed or contained invalid data.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Unauthorized - Authentication failed due to missing or invalid credentials."
      },
      "UnprocessableEntity": {
        "description": "Unprocessable Entity - The request was well-formed but could not be processed due to semantic errors.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/DomainErrorResponse"
            }
          }
        }
      },
      "CreatedTransaction": {
        "description": "Successful transaction creation.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/TransactionResponse"
            },
            "examples": {
              "EWalletResponseWithRedirect": {
                "summary": "Transaction using e-Wallet (Paypal)",
                "description": "Response for an e-Wallet transaction requiring redirect",
                "value": {
                  "code": "25a58ef1-3755-476b-b2f6-e445b170a849",
                  "reference": "REF-XXX-1733152707223",
                  "status": "PENDING",
                  "amount": 101.1,
                  "currency": "USD",
                  "country": "US",
                  "created_at": "2021-04-12T12:43:13Z",
                  "payment_instructions": {
                    "interaction_type": [
                      "REDIRECT"
                    ],
                    "redirect": {
                      "url": "https://checkout.international.pagseguro.com"
                    }
                  }
                }
              },
              "PIXResponseWithQRCode": {
                "summary": "Transaction using PIX",
                "description": "Response for a PIX transaction requiring redirect",
                "value": {
                  "code": "e0768ae3-14ce-4b26-a40c-50382167cf34",
                  "reference": "REF-BR-bdfcdd5a-5e32-4175-84a9-9da6bec72d74",
                  "amount": 59.9,
                  "status": "PENDING",
                  "currency": "BRL",
                  "country": "BR",
                  "payment_instructions": {
                    "interaction_type": [
                      "CODE"
                    ],
                    "type": "QR_CODE",
                    "value": "00020101021226830014br.gov.bcb.pix2561api.pagseguro.com/pix/v2/6D76A965-3817-4F75-9730-B1C4D91D43D65204601253039865802BR5922PAGSEGUROTECNOLOGIAL6007Maringa62070503***6304E551",
                    "image": "https://api.pagseguro.com/qrcode/QRCO_6D76A965-3817-4F75-9730-B1C4D91D43D6/png"
                  },
                  "created_at": "2026-05-14T19:02:32Z"
                }
              },
              "RawCreditCard": {
                "summary": "Transaction using raw credit card",
                "value": {
                  "code": "25a58ef1-3755-476b-b2f6-e445b170a849",
                  "reference": "REF-XXX-1234567890",
                  "status": "PENDING",
                  "amount": 101.1,
                  "installments": 1,
                  "currency": "BRL",
                  "country": "BR",
                  "created_at": "2021-04-12T12:43:13Z"
                }
              },
              "TokenCreditCard": {
                "summary": "Transaction using tokenized credit card",
                "value": {
                  "code": "25a58ef1-3755-476b-b2f6-e445b170a849",
                  "reference": "REF-XXX-1234567890",
                  "status": "PENDING",
                  "amount": 101.1,
                  "installments": 1,
                  "currency": "BRL",
                  "country": "BR",
                  "created_at": "2021-04-12T12:43:13Z"
                }
              },
              "GooglePay": {
                "summary": "Transaction using Google Pay",
                "value": {
                  "code": "25a58ef1-3755-476b-b2f6-e445b170a849",
                  "reference": "REF-XXX-1234567890",
                  "status": "PENDING",
                  "amount": 101.1,
                  "installments": 1,
                  "currency": "BRL",
                  "country": "BR",
                  "created_at": "2021-04-12T12:43:13Z"
                }
              },
              "RawCreditCardWithInstalments": {
                "summary": "Transaction with installments",
                "value": {
                  "code": "25a58ef1-3755-476b-b2f6-e445b170a849",
                  "reference": "REF-XXX-1234567890",
                  "status": "PENDING",
                  "amount": 101.1,
                  "installments": 6,
                  "currency": "BRL",
                  "country": "BR",
                  "created_at": "2021-04-12T12:43:13Z"
                }
              },
              "CreatePaymentAndGetToken": {
                "summary": "Create a payment and get a token",
                "value": {
                  "code": "25a58ef1-3755-476b-b2f6-e445b170a849",
                  "created_at": "2025-11-06T17:07:16Z",
                  "reference": "REF-XXX-1234567890",
                  "status": "PENDING",
                  "amount": 101.1,
                  "currency": "BRL",
                  "country": "BR",
                  "type": "CREDIT_CARD",
                  "method": "MASTERCARD",
                  "credit_card": {
                    "last_four": 1234,
                    "bin": 123546,
                    "expiration_date": "YYYY-MM",
                    "id": "41122c49-0099-447d-8d20-fd5f4cb38050"
                  },
                  "recurrence": {
                    "id": "86b463d2-1720-46ec-8aa3-d17763c62cee",
                    "type": "CARD_ON_FILE",
                    "scheduling": "INITIAL"
                  }
                }
              },
              "CreatePaymentsUsingTheToken": {
                "summary": "Create a payment using the token",
                "value": {
                  "code": "69358ab2-453f-4c20-a0a2-866a510a599a",
                  "created_at": "2025-11-06T17:10:25Z",
                  "reference": "Ref-store-multiauth-1762449021036",
                  "amount": 1,
                  "status": "PENDING",
                  "currency": "BRL",
                  "country": "BR",
                  "credit_card": {
                    "id": "86b463d2-1720-46ec-8aa3-d17763c62cee",
                    "bin": "555566",
                    "last_four": "8884",
                    "expiration_date": "2026-12"
                  },
                  "recurrence": {
                    "id": "86b463d2-1720-46ec-8aa3-d17763c62cee",
                    "type": "CARD_ON_FILE",
                    "scheduling": "SUBSEQUENT"
                  }
                }
              },
              "PSEResponseRedirect": {
                "summary": "Transaction using PSE Avanza",
                "description": "Response for a PSE Avanza transaction requiring redirect",
                "value": {
                  "integration": {
                    "reference": "Ref-9d52a4be-dd1d-4644-b83c-5bb5873db992-testglauco4",
                    "notification_url": "https://www.merchant.com/notify",
                    "language\"": "pt_BR",
                    "redirect_urls": {
                      "success": "https://www.merchant.com/success",
                      "failure": "https://www.merchant.com/failure"
                    }
                  },
                  "order": {
                    "currency": "COP",
                    "items": [
                      {
                        "quantity": 1,
                        "description": "Test",
                        "unit_price": 4000
                      }
                    ]
                  },
                  "charge": {
                    "country": "CO",
                    "method": "PSE_AVANZA",
                    "pse_avanza": {
                      "bank_code": "1059"
                    }
                  },
                  "payer": {
                    "email": "payer@example.example.com",
                    "ip": "64.237.155.62",
                    "person": {
                      "name": "JOAO DA SILVA",
                      "birth_date": "1999-11-04",
                      "document": {
                        "type": "CE",
                        "number": "Z778899"
                      },
                      "phone": {
                        "country_code": "59",
                        "number": "6999343434"
                      }
                    },
                    "address": {
                      "street": "Avenida Brasil",
                      "state": "PR",
                      "city": "Maringá"
                    }
                  }
                }
              },
              "NequiResponseRedirect": {
                "summary": "Transaction using Nequi",
                "description": "Response for a Nequi transaction requiring redirect",
                "value": {
                  "integration": {
                    "reference": "Ref-9d52a4be-dd1d-4644-b83c-5bb5873db992-testglauco4",
                    "notification_url": "https://www.merchant.com/notify",
                    "language": "pt_BR",
                    "redirect_urls": {
                      "success": "https://www.merchant.com/success",
                      "failure": "https://www.merchant.com/failure"
                    }
                  },
                  "order": {
                    "currency": "COP",
                    "items": [
                      {
                        "quantity": 1,
                        "description": "Test",
                        "unit_price": 4000
                      }
                    ]
                  },
                  "charge": {
                    "country": "CO",
                    "method": "PSE_AVANZA",
                    "pse_avanza": {
                      "bank_code": "1059"
                    }
                  },
                  "payer": {
                    "email": "payer@example.example.com",
                    "ip": "64.237.155.62",
                    "person": {
                      "name": "JOAO DA SILVA",
                      "birth_date": "1999-11-04",
                      "document": {
                        "type": "CE",
                        "number": "Z778899"
                      },
                      "phone": {
                        "country_code": "59",
                        "number": "6999343434"
                      }
                    },
                    "address": {
                      "street": "Avenida Brasil",
                      "state": "PR",
                      "city": "Maringá"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Direct API",
      "description": "Operations related to creating transactions using the Direct API."
    }
  ],
  "paths": {
    "/v3/transactions": {
      "post": {
        "summary": "Create a Transaction",
        "operationId": "create-transaction",
        "description": "Creates a new transaction. You can use this endpoint to create payments when using:\n- Raw credit card (only available for PCI merchants)\n- Credit card token\n- Card on File token (Token stored by PagSeguro)\n- Google Pay\n- Pix\n- PSE Avanza\n- Nequi\n\nFor the accepted document types and validation rules per country, see [Document Validation](ref:document-validation).\n",
        "tags": [
          "Direct API"
        ],
        "security": [
          {
            "basicAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TransactionRequest"
              },
              "examples": {
                "CreateEWalletTransaction": {
                  "summary": "e-Wallet (PayPal)",
                  "value": {
                    "integration": {
                      "reference": "REF-PAYPAL-12345",
                      "notification_url": "https://www.merchantwebsite.com/notify",
                      "language": "en_US",
                      "redirect_urls": {
                        "success": "https://www.merchantwebsite.com/successFlow",
                        "failure": "https://www.merchantwebsite.com/returnFlow"
                      }
                    },
                    "order": {
                      "currency": "USD",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "ProductPaypal",
                          "unit_price": 101.1
                        }
                      ]
                    },
                    "charge": {
                      "country": "US",
                      "method": "PAYPAL"
                    },
                    "payer": {
                      "email": "payer-paypal@example.com",
                      "ip": "192.0.2.146",
                      "person": {
                        "name": "PayPal Payer Name",
                        "birth_date": "1980-05-20",
                        "document": {
                          "type": "CPF",
                          "number": "12345678901"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "11987654321"
                        }
                      }
                    }
                  }
                },
                "CreateRawCreditCard": {
                  "summary": "Raw credit card",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "pt_BR"
                    },
                    "order": {
                      "currency": "BRL",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "ProductDescription",
                          "unit_price": 101.1
                        }
                      ]
                    },
                    "charge": {
                      "country": "BR",
                      "type": "CREDIT_CARD",
                      "credit_card": {
                        "raw": {
                          "number": "4073020000000002",
                          "cvc": "123",
                          "expiration_month": "12",
                          "expiration_year": "2028"
                        },
                        "holder_name": "jonh doe"
                      }
                    },
                    "payer": {
                      "email": "payer@example.com",
                      "ip": "192.0.2.146",
                      "person": {
                        "name": "Mr Payer Full Name",
                        "birth_date": "1970-01-01",
                        "document": {
                          "type": "CPF",
                          "number": "98765432101"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "44900000000"
                        }
                      }
                    }
                  }
                },
                "TokenCreditCard": {
                  "summary": "Tokenized credit card",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "pt_BR"
                    },
                    "order": {
                      "currency": "BRL",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "Product description",
                          "unit_price": 101.1
                        }
                      ]
                    },
                    "charge": {
                      "country": "BR",
                      "type": "CREDIT_CARD",
                      "credit_card": {
                        "token": "eyJkbmEiOiI2NzY3YzAxNDEzNGM0NTc4ODg0ZjU2MjdmYTI0ZGVhZiIsImlwIjoiMjAwLjIyMS4xMzAuNDkiLCJkZiI6ImNmYWI3MDcxMDJlZDQ4MjU4MzJhNmY2MDBhNWZjZjc2In0=",
                        "holder_name": "jonh doe"
                      }
                    },
                    "payer": {
                      "email": "payer@example.com",
                      "ip": "192.0.2.146",
                      "person": {
                        "name": "Mr. Payer Full Name",
                        "birth_date": "1970-01-01",
                        "document": {
                          "type": "CPF",
                          "number": "98765432101"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "44900000000"
                        }
                      }
                    }
                  }
                },
                "GooglePay": {
                  "summary": "Google Pay",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "pt_BR"
                    },
                    "order": {
                      "currency": "BRL",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "Product description",
                          "unit_price": 101.1
                        }
                      ]
                    },
                    "charge": {
                      "country": "BR",
                      "type": "CREDIT_CARD",
                      "credit_card": {
                        "google_pay": {
                          "token": "{\"signature\":\"MEUCIQCpdjkwGbZHReTIo/G5muX0mpbbSE1Yo2L0Sk68GRQXegIgX4evAuOb8+SrYyUMV42isn4wABuoyKveYkwF/y3bLCM\\u003d\",\"intermediateSigningKey\":{\"signedKey\":\"{\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEn58WtMd+S2bLaqUAVWpilWWzQBu8t9Xm5zgb6AN5buOcYbVG2ELx59XZGcYo3KscSY6h/x2XuRoBBE5DFR4VNA\\\\u003d\\\\u003d\\\",\\\"keyExpiration\\\":\\\"1700159511279\\\"}\",\"signatures\":[\"MEUCIQDkLiLhgYLkhq7sXKHD+uyv/bZjDbiwqbugNUIyOT1YAwIgEjfLQ77q6cgIcTNyetxIYHUSyghtshmkxsEzx5vDcyk\\u003d\"]},\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"MU6eLCx3Pm2iTvsvOI2n73KmTavd9IyEtDBG1lEP33klvkwGH4Sb6AlJ2ocDW3IP6X1XK6Cd5clMGEWL0nsMazpCdxdyIhGjyMmtQaKBm0kyRe2/UAPTMMp4++sHPPs5q7GXFz/89KSEYxJUnfDWe73o8dEzlUqUro3Ik5jpaFcWXZppUgYaTVCGawKky+DML54LEvVK4WVfjsJs1MrSa8bgtYXq2AsHlvOWWnxBp+uv96mV4BOt8kveaZ5RQJIRiqVXIcx45ayakPaOS8cTAVqQA0/buiQiJmrfLVzMsqIOqJost88XGPk0y1SC4DdxA1uy8S/GckNlyIyZ3qjrPrBX7st5L+yLnGBFZYtgYFUW7hbcY1ELV8Xtno0n4PTDrgJv4FOScSbyJ49cTZG+mgbJnoa1mRm1I3s2yVRylBoJ5PiHcPRPXVrjWhUMBU5G5e0ePRl3fgNkd9qUD6TZ3tWyvjSGtKsxSLJ8ijj0ic06OI0Q4eqtJRx3ESjZALOYqLfGO8PRtc7Ul03yMgnJwlgHtxsab1ex1UJRSFCKl6mE8PE3UIqx211OX1GIIMn6\\\",\\\"ephemeralPublicKey\\\":\\\"BFNPLyTVg9SmjR7p0u5OdXKxKsjB7AXTKN6IhIEKCyBBwUUEdyswU62+iCPcuAAAUVvjNvR/1WNrFatpichAGlk\\\\u003d\\\",\\\"tag\\\":\\\"U5/T1RpIXRCrvDdfQhofxCxXMyfJ4it5mZTa1WihLOI\\\\u003d\\\"}\"}"
                        },
                        "holder_name": "Jonh Doe"
                      }
                    },
                    "payer": {
                      "email": "payer@example.com",
                      "ip": "192.0.2.146",
                      "person": {
                        "name": "Mr. Payer Full Name",
                        "birth_date": "1970-01-01",
                        "document": {
                          "type": "CPF",
                          "number": "98765432101"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "44900000000"
                        }
                      }
                    }
                  }
                },
                "CreatePaymentAndGetToken": {
                  "summary": "Create a payment and get a token",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "pt_BR"
                    },
                    "order": {
                      "currency": "BRL",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "Product description",
                          "unit_price": 101.1
                        }
                      ]
                    },
                    "charge": {
                      "country": "BR",
                      "type": "CREDIT_CARD",
                      "credit_card": {
                        "raw": {
                          "number": "4073020000000002",
                          "cvc": "123",
                          "expiration_month": "12",
                          "expiration_year": "2028"
                        },
                        "holder_name": "jonh doe",
                        "store": true
                      }
                    },
                    "payer": {
                      "email": "payer@example.com",
                      "ip": "192.0.2.146",
                      "person": {
                        "name": "Mr. Payer Full Name",
                        "birth_date": "1970-01-01",
                        "document": {
                          "type": "CPF",
                          "number": "98765432101"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "44900000000"
                        }
                      }
                    }
                  }
                },
                "CreatePaymentsUsingTheToken": {
                  "summary": "Create a payment using the token",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "pt_BR"
                    },
                    "order": {
                      "currency": "BRL",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "Product description",
                          "unit_price": 101.1
                        }
                      ]
                    },
                    "charge": {
                      "country": "BR",
                      "type": "CREDIT_CARD",
                      "credit_card": {
                        "card_on_file": {
                          "id": "7e18637f-f3ee-4ce2-adaf-05c5ceae3833",
                          "cvc": "123"
                        }
                      }
                    },
                    "payer": {
                      "email": "payer@example.com",
                      "ip": "192.0.2.146",
                      "person": {
                        "name": "Mr. Payer Full Name",
                        "birth_date": "1970-01-01",
                        "document": {
                          "type": "CPF",
                          "number": "98765432101"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "44900000000"
                        }
                      }
                    }
                  }
                },
                "RawCreditCardWithInstallments": {
                  "summary": "Credit card wth Installments",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "pt_BR"
                    },
                    "order": {
                      "currency": "BRL",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "Product description",
                          "unit_price": 101.1
                        }
                      ]
                    },
                    "charge": {
                      "country": "BR",
                      "installments": 6,
                      "type": "CREDIT_CARD",
                      "credit_card": {
                        "raw": {
                          "number": "4073020000000002",
                          "cvc": "123",
                          "expiration_month": "12",
                          "expiration_year": "2028"
                        },
                        "holder_name": "jonh doe"
                      }
                    },
                    "payer": {
                      "email": "payer@example.com",
                      "ip": "192.0.2.146",
                      "person": {
                        "name": "Mr Payer Full Name",
                        "birth_date": "1970-01-01",
                        "document": {
                          "type": "CPF",
                          "number": "98765432101"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "44900000000"
                        }
                      }
                    }
                  }
                },
                "CreatePixTransaction": {
                  "summary": "Pix",
                  "value": {
                    "integration": {
                      "reference": "REF-BR-987654321",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "pt_BR"
                    },
                    "order": {
                      "currency": "BRL",
                      "items": [
                        {
                          "quantity": 1,
                          "description": "Assinatura mensal",
                          "unit_price": 59.9
                        }
                      ]
                    },
                    "charge": {
                      "country": "BR",
                      "method": "PIX"
                    },
                    "payer": {
                      "email": "cliente@exemplo.com",
                      "ip": "189.204.23.121",
                      "person": {
                        "name": "João da Silva",
                        "birth_date": "1985-03-10",
                        "document": {
                          "type": "CPF",
                          "number": "12345678909"
                        },
                        "phone": {
                          "country_code": "55",
                          "number": "11987654321"
                        }
                      }
                    }
                  }
                },
                "CreatePSEAvanzaTransaction": {
                  "summary": "PSE Avanza",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "es_CO",
                      "redirect_urls": {
                        "success": "https://example.com/payment/success",
                        "failure": "https://example.com/payment/failure"
                      }
                    },
                    "order": {
                      "currency": "COP"
                    },
                    "charge": {
                      "country": "CO",
                      "method": "PSE_AVANZA",
                      "pse_avanza": {
                        "bank_code": "0000"
                      }
                    },
                    "payer": {
                      "address": {
                        "street": "Cl. 77",
                        "number": "112",
                        "complement": "",
                        "district": "Bogota",
                        "state": "BO",
                        "city": "Bogota",
                        "country": "CO",
                        "zip_code": "110541"
                      }
                    }
                  }
                },
                "CreateNequiTransaction": {
                  "summary": "Nequi",
                  "value": {
                    "integration": {
                      "reference": "REF-XXX-1234567890",
                      "notification_url": "https://www.merchantwebsite.com/notify?type=transaction",
                      "language": "es_CO",
                      "redirect_urls": {
                        "success": "https://example.com/payment/success",
                        "failure": "https://example.com/payment/failure"
                      }
                    },
                    "order": {
                      "currency": "COP"
                    },
                    "charge": {
                      "country": "CO",
                      "method": "PSE_AVANZA",
                      "pse_avanza": {
                        "bank_code": "1507"
                      }
                    },
                    "payer": {
                      "address": {
                        "street": "Cl. 77",
                        "number": "112",
                        "complement": "",
                        "district": "Bogota",
                        "state": "BO",
                        "city": "Bogota",
                        "country": "CO",
                        "zip_code": "110541"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/CreatedTransaction"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableEntity"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```