Transactions

View and manage payment transactions.

Transactions are sandbox-aware.

List Transactions

List transactions, sorted by most recent.

GEThttps://paysio.com/api/v1/transactions

Authorizations

Authorizationstringheaderrequired

Any API key. Prepend your key with Bearer, e.g. Bearer sk_test_your_secret_key.

Query parameters

limitinteger

1-100, default 10

starting_afterstring

Cursor for pagination

Example request — cURL

curl -X GET https://paysio.com/api/v1/transactions \
  -H "Authorization: Bearer sk_test_your_secret_key"

Example request — JavaScript

const res = await fetch("https://paysio.com/api/v1/transactions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer sk_test_your_secret_key"
  },
})
const data = await res.json()

Example response (200)

{
  "data": [
    {
    "object": "transaction",
    "id": "txn_6b1e0d3a-9f7c-4d21-8a54-2c3b1e0f9a8d",
    "workspaceId": "3d9b2e10-7c44-4a2f-bb8e-1f6a2c3d4e5f",
    "orderNumber": 1042,
    "customerId": "cus_8f2a1c9e-4b3d-47a1-9e12-0a5f6c7d8b90",
    "subscriptionId": null,
    "discountCode": null,
    "discountAmount": 0,
    "nmiTransactionId": "10293847561",
    "rail": "card",
    "processorType": "nmi",
    "amount": 2999,
    "currency": "USD",
    "status": "settled",
    "authCode": "123456",
    "avsResponse": "Y",
    "cvvResponse": "M",
    "riskScore": 10,
    "riskDecision": "allow",
    "cardLastFour": "4242",
    "cardBin": "424242",
    "cardType": "visa",
    "walletType": null,
    "billingFirstName": "Jane",
    "billingLastName": "Doe",
    "billingEmail": "[email protected]",
    "billingCountry": "US",
    "items": [
      { "productId": "prd_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "productName": "Pro Plan", "quantity": 1, "unitPrice": 2999, "currency": "USD" }
    ],
    "taxAmount": 0,
    "shippingAmount": 0,
    "cardSurchargeAmount": 0,
    "customFields": [],
    "metadata": { "ip": "203.0.113.42", "country": "United States" },
    "refundedAmount": 0,
    "voidedAt": null,
    "refundedAt": null,
    "settledAt": "2026-06-28T22:00:11.004Z",
    "disputedAt": null,
    "threeDsStatus": null,
    "threeDsEci": null,
    "fulfillmentStatus": null,
    "sandbox": false,
    "createdAt": "2026-06-28T14:12:06.882Z",
    "orderLabel": "#01042"
  }
  ],
  "has_more": false
}

Example response (400)

{
  "error": "Invalid request parameters",
  "type": "invalid_request_error",
  "code": "parameter_invalid"
}

Example response (401)

{
  "error": "Invalid API key provided",
  "type": "authentication_error",
  "code": "api_key_invalid"
}

Example response (429)

{
  "error": "Too many requests",
  "type": "rate_limit_error",
  "code": "rate_limited"
}

Get Transaction

Retrieve a single transaction.

GEThttps://paysio.com/api/v1/transactions/:id

Authorizations

Authorizationstringheaderrequired

Any API key. Prepend your key with Bearer, e.g. Bearer sk_test_your_secret_key.

Example request — cURL

curl -X GET https://paysio.com/api/v1/transactions/:id \
  -H "Authorization: Bearer sk_test_your_secret_key"

Example request — JavaScript

const res = await fetch("https://paysio.com/api/v1/transactions/:id", {
  method: "GET",
  headers: {
    "Authorization": "Bearer sk_test_your_secret_key"
  },
})
const data = await res.json()

Example response (200)

{
  "data": {
    "object": "transaction",
    "id": "txn_6b1e0d3a-9f7c-4d21-8a54-2c3b1e0f9a8d",
    "workspaceId": "3d9b2e10-7c44-4a2f-bb8e-1f6a2c3d4e5f",
    "orderNumber": 1042,
    "customerId": "cus_8f2a1c9e-4b3d-47a1-9e12-0a5f6c7d8b90",
    "subscriptionId": null,
    "discountCode": null,
    "discountAmount": 0,
    "nmiTransactionId": "10293847561",
    "rail": "card",
    "processorType": "nmi",
    "amount": 2999,
    "currency": "USD",
    "status": "settled",
    "authCode": "123456",
    "avsResponse": "Y",
    "cvvResponse": "M",
    "riskScore": 10,
    "riskDecision": "allow",
    "cardLastFour": "4242",
    "cardBin": "424242",
    "cardType": "visa",
    "walletType": null,
    "billingFirstName": "Jane",
    "billingLastName": "Doe",
    "billingEmail": "[email protected]",
    "billingCountry": "US",
    "items": [
      { "productId": "prd_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "productName": "Pro Plan", "quantity": 1, "unitPrice": 2999, "currency": "USD" }
    ],
    "taxAmount": 0,
    "shippingAmount": 0,
    "cardSurchargeAmount": 0,
    "customFields": [],
    "metadata": { "ip": "203.0.113.42", "country": "United States" },
    "refundedAmount": 0,
    "voidedAt": null,
    "refundedAt": null,
    "settledAt": "2026-06-28T22:00:11.004Z",
    "disputedAt": null,
    "threeDsStatus": null,
    "threeDsEci": null,
    "fulfillmentStatus": null,
    "sandbox": false,
    "createdAt": "2026-06-28T14:12:06.882Z",
    "orderLabel": "#01042"
  }
}

Example response (401)

{
  "error": "Invalid API key provided",
  "type": "authentication_error",
  "code": "api_key_invalid"
}

Example response (404)

{
  "error": "Resource not found",
  "type": "not_found_error",
  "code": "resource_missing"
}

Example response (429)

{
  "error": "Too many requests",
  "type": "rate_limit_error",
  "code": "rate_limited"
}

Void Transaction

Void a pending transaction. Only works on transactions with status 'pending_settlement'.

POSThttps://paysio.com/api/v1/transactions/:id/void

Authorizations

Authorizationstringheaderrequired

Secret key (sk_*). Prepend your key with Bearer, e.g. Bearer sk_test_your_secret_key.

Example request — cURL

curl -X POST https://paysio.com/api/v1/transactions/:id/void \
  -H "Authorization: Bearer sk_test_your_secret_key"

Example request — JavaScript

const res = await fetch("https://paysio.com/api/v1/transactions/:id/void", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_test_your_secret_key"
  },
})
const data = await res.json()

Example response (200)

{
  "data": {
    "id": "uuid",
    "orderNumber": 19,
    "orderLabel": "#00019",
    "amount": 2999,
    "currency": "USD",
    "status": "voided",
    "cardType": "visa",
    "cardLastFour": "4242",
    "nmiTransactionId": "123456789",
    "voidedAt": "2026-01-15T12:00:00.000Z",
    "createdAt": "2026-01-15T10:30:00.000Z"
  }
}

Example response (401)

{
  "error": "Invalid API key provided",
  "type": "authentication_error",
  "code": "api_key_invalid"
}

Example response (404)

{
  "error": "Resource not found",
  "type": "not_found_error",
  "code": "resource_missing"
}

Example response (429)

{
  "error": "Too many requests",
  "type": "rate_limit_error",
  "code": "rate_limited"
}

Refund Transaction

Refund a settled transaction. Supports partial refunds by specifying an amount. On Debit & Payouts workspaces a refund is issued as a reverse payout back to the original instrument — the response includes a refund_payout object and the refund settles asynchronously (payment.refunded fires immediately, the payout itself follows the payout lifecycle). Requires the original charge to have a saved instrument.

POSThttps://paysio.com/api/v1/transactions/:id/refund

Authorizations

Authorizationstringheaderrequired

Secret key (sk_*). Prepend your key with Bearer, e.g. Bearer sk_test_your_secret_key.

Body

amountinteger

Amount to refund in cents. Omit for full refund.

send_emailboolean

Send the Paysio refund email to the customer. Default true. Debit & Payouts only — the other gateways send no refund email.

Example request — cURL

curl -X POST https://paysio.com/api/v1/transactions/:id/refund \
  -H "Authorization: Bearer sk_test_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 0,
  "send_email": false
}'

Example request — JavaScript

const res = await fetch("https://paysio.com/api/v1/transactions/:id/refund", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_test_your_secret_key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "amount": 0,
    "send_email": false
  }),
})
const data = await res.json()

Example response (200)

{
  "data": {
    "id": "uuid",
    "orderNumber": 19,
    "orderLabel": "#00019",
    "amount": 2999,
    "currency": "USD",
    "status": "refunded",
    "cardType": "visa",
    "cardLastFour": "4242",
    "nmiTransactionId": "123456789",
    "refundedAmount": 2999,
    "refundedAt": "2026-01-15T12:00:00.000Z",
    "createdAt": "2026-01-15T10:30:00.000Z"
  }
}

Example response (400)

{
  "error": "Invalid request parameters",
  "type": "invalid_request_error",
  "code": "parameter_invalid"
}

Example response (401)

{
  "error": "Invalid API key provided",
  "type": "authentication_error",
  "code": "api_key_invalid"
}

Example response (404)

{
  "error": "Resource not found",
  "type": "not_found_error",
  "code": "resource_missing"
}

Example response (429)

{
  "error": "Too many requests",
  "type": "rate_limit_error",
  "code": "rate_limited"
}