TuCapiDocs

Get started

Introduction

Accept PayPal, Zelle and card payments from your own system with the TuCapi Business API.

How it works

The API lets you get paid from your own system. The flow has five steps:

  1. 1Your server creates a charge with POST /v1/charges.
  2. 2You send your customer to the charge's checkoutUrl, or show checkout inside your site.
  3. 3Your customer picks how to pay: PayPal, Zelle or card. That creates an order.
  4. 4We notify you by webhook (order.paid) when the payment is confirmed.
  5. 5The net amount is credited to your balance in USDT.
curl -X POST https://api.business.tucapi.com/v1/charges \  -H "Authorization: Bearer $TUCAPI_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: ORD-1042" \  -d '{    "amount": "125.00",    "description": "Pedido #1042",    "reference": "ORD-1042",    "metadata": {      "customerId": "c_88"    },    "allowedMethods": [      "paypal",      "card"    ],    "expiresAt": "2026-09-16T12:00:00Z"  }'
Response
{  "object": "charge",  "id": "9b1e2d3c-4f5a-4b6c-8d7e-0f1a2b3c4d5e",  "status": "open",  "amount": "125.00",  "currency": "USD",  "description": "Pedido #1042",  "reference": "ORD-1042",  "metadata": {    "customerId": "c_88"  },  "allowedMethods": [    "paypal",    "card"  ],  "checkoutUrl": "https://pay.tucapi.com/k7x2m9qz",  "embedUrl": "https://pay.tucapi.com/embed/k7x2m9qz",  "expiresAt": "2026-09-16T12:00:00Z",  "paidAt": null,  "createdAt": "2026-09-15T18:42:07Z",  "orders": []}

Concepts

ObjectWhat it is
Charge (charge)What you create. It has an amount, a description and a checkout URL. It can be paid once.
Order (order)A single payment attempt. Created when your customer picks a method at checkout.
Balance (balance)What's been credited to you in USDT: available and on hold.
WebhookA signed notice we send to your server when something happens.
StatementThe monthly summary of the fees we deducted.

Base URL

Every call goes to this URL, over HTTPS:

URL
https://api.business.tucapi.com/v1

Important

There is only a live environment. There's no sandbox yet: every charge that gets paid is real.

Next steps