SelectwinDOCS
Transactions

Retrieve a transaction

GET
/v1/transactions/{transactionId}

Authorization

selectkey<token>

API key para requisições autenticadas. Envie sua chave no cabeçalho selectkey (sandbox sk_test_…, produção sk_live_…).

In: header

Path Parameters

transactionId*string

Public identifier (tra_/trx_…)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/transactions/string"
{
  "id": "tra_0a1b2c3d4e5f60718293",
  "customId": "string",
  "amount": 5000,
  "originalAmount": 5000,
  "fees": 5000,
  "net": 0,
  "status": "pending",
  "method": "credit",
  "currency": "BRL",
  "payment": {
    "provider": "selectwin",
    "version": "1.1",
    "reusable": true,
    "billetUrl": "string",
    "billetBarcode": "string",
    "billetSequence": "string",
    "billetDocumentNumber": "string",
    "billetReferenceNumber": "string",
    "pixQrCodeEmv": "string",
    "pixQrCodeUrl": "string",
    "pixQrCodeImage": "string",
    "acquirerTransactionNumber": "string",
    "cardFirstDigits": "string",
    "cardLastDigits": "string",
    "cardBrand": "string",
    "cardRegistered": true,
    "installments": 0,
    "expirationDate": "string",
    "paidAt": "string",
    "allowRenewPayment": true,
    "invoiceLink": "string"
  },
  "discount": {
    "value": 5000,
    "type": "string",
    "percentageOfAmount": 5000
  },
  "discounts": [],
  "customer": {
    "id": "cus_0a1b2c3d4e5f60718293",
    "firstName": "João",
    "lastName": "Silva",
    "email": "[email protected]",
    "birthdate": "string",
    "gender": "string",
    "document": {
      "type": "string",
      "number": "string"
    },
    "telephone": {
      "countryCode": "string",
      "areaCode": "string",
      "number": "string",
      "line": "string"
    },
    "available": true,
    "delinquent": true,
    "externalReference": "string",
    "updatedAt": "string",
    "createdAt": "string"
  },
  "billing": {
    "address": {
      "id": "string",
      "ownerId": "string",
      "ownerType": "string",
      "street": "string",
      "number": "string",
      "complement": "string",
      "district": "string",
      "city": "string",
      "state": "string",
      "postcode": "string",
      "country": "string",
      "latitude": "string",
      "longitude": "string",
      "line": "string",
      "line1": "string",
      "line2": "string",
      "line3": "string",
      "updatedAt": "string",
      "createdAt": "string"
    }
  },
  "externalReference": "string",
  "shippable": true,
  "spplited": true,
  "items": [
    {
      "id": "item_0a1b2c3d4e5f60718293",
      "name": "Acme Ltda",
      "unitPrice": 5000,
      "quantity": 0,
      "currency": "BRL",
      "description": "string",
      "images": [
        "string"
      ],
      "isUpsell": true,
      "isOrderbump": true,
      "variantId": "string",
      "externalReference": "string",
      "updatedAt": "string",
      "createdAt": "string"
    }
  ],
  "receivables": [
    {
      "id": "string",
      "recipient": "string",
      "split": "string",
      "status": "string",
      "amount": 5000,
      "grossAmount": 5000,
      "anticipationFee": 5000,
      "installmentNumber": 0,
      "description": "string",
      "currency": "BRL",
      "authorizationCode": "string",
      "paidAt": "string",
      "refundedAt": "string",
      "canceledAt": "string",
      "expectedOn": "string",
      "liable": true,
      "chargeProcessingFee": true,
      "updatedAt": "string",
      "createdAt": "string"
    }
  ],
  "splits": [
    {
      "id": "string",
      "recipient": "string",
      "receivable": "string",
      "amount": 5000,
      "grossAmount": 5000,
      "percentage": "string",
      "description": "string",
      "chargeProcessingFee": true,
      "updatedAt": "string",
      "createdAt": "string"
    }
  ],
  "refunds": [
    {
      "id": "void_0a1b2c3d4e5f60718293",
      "description": "string",
      "receiptId": "string",
      "amount": 5000,
      "category": "string",
      "observations": "string",
      "updatedAt": "string",
      "createdAt": "string"
    }
  ],
  "disputes": [
    {
      "id": "string",
      "returnEmail": "string",
      "description": "string",
      "updatedAt": "string",
      "createdAt": "string"
    }
  ],
  "timeline": [
    {
      "id": "string",
      "message": "string",
      "details": "string",
      "type": "string",
      "updatedAt": "string",
      "createdAt": "string"
    }
  ],
  "callback": {
    "webhookUrl": "string",
    "active": true
  },
  "processingTimeMs": 0,
  "updatedAt": "string",
  "createdAt": "string",
  "merchant": {
    "name": "Acme Ltda",
    "merchantId": "string",
    "isSubAccount": true
  },
  "_links": {}
}
{
  "error": {
    "status": "Unauthorized",
    "statusCode": 401,
    "category": "authentication",
    "code": "unauthorized",
    "message": "Authentication is required to access this resource.",
    "resource": "server"
  }
}
{
  "error": {
    "status": "Forbidden",
    "statusCode": 403,
    "category": "authorization",
    "code": "forbidden",
    "message": "You do not have permission to perform this action.",
    "resource": "server"
  }
}
{
  "error": {
    "status": "Internal Server Error",
    "statusCode": 500,
    "category": "server",
    "code": "notFound",
    "message": "An unexpected error occurred.",
    "resource": "server"
  }
}
{
  "error": {
    "status": "Internal Server Error",
    "statusCode": 500,
    "category": "server",
    "code": "serverError",
    "message": "An unexpected error occurred. Please try again later.",
    "resource": "server",
    "details": "If the problem persists, contact support with the correlationId from the response headers."
  }
}

Create a transaction (charge) POST

Create a transaction (charge) **Conditional rules (enforced by the API; not in the JSON Schema):** - `payment.method=credit` requires `payment.card.id`. - `payment.method=billet` requires `billing.address.id`. - If `items[]` is sent, `sum(unitPrice*quantity)` must equal `amount`. - A percentage `discount.value` cannot exceed 100; `discount` and `coupon` are mutually exclusive. See the per-method examples (credit / pix / billet / creditWithCart).

List transactions GET

Next Page