v1

latestOpenAPI 3.1.02026-07-24102785.8 KB

Direct API

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.

post/v3/transactions

Request body

Example request

{
  "charge": {
    "installments": 6,
    "credit_card": {
      "id": "3e233f49-04d0-40ee-ae13-984e2b7988a4"
    },
    "authentication_method": {
      "type": "3DS",
      "cavv": "BwABBylVaQAAAAFwllVpAAAAAAA=",
      "xid": "BwABBylVaQAAAAFwllVpAAAAAAA=",
      "eci": "05",
      "version": "2.1.0",
      "dstrans_id": "DIR_SERVER_TID"
    }
  }
}

Response

Successful transaction creation.

codestring uuid

Transaction UUID code.

referencestring

Transaction reference code in the merchant's store.

statusstring

Status of the created transaction.

amountnumber float

The amount charged for the transaction.

installmentsnumber

The number of installments of the transaction.

currencystring

The currency used for billing.

countrystring

The country of origin informed in the transaction.

created_atstring date-time

Transaction creation date in Coordinated Universal Time (UTC).