SelectwinDOCS
Transactions

Capture a pre-authorized transaction

POST
/v1/transactions/{transactionId}/capture

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_…)

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/transactions/string/capture" \  -H "Content-Type: application/json" \  -d '{    "amount": 5000  }'
{
  "transactionId": "tra_0a1b2c3d4e5f60718293",
  "status": "pending",
  "accepted": true
}
{
  "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": "Bad Request",
    "statusCode": 400,
    "category": "validation",
    "code": "invalidParameters",
    "message": "Validation errors 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."
  }
}

List cards GET

Previous Page

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).