Skip to content
/Payment

Overview

Our Banking as a Service (BaaS) platform is designed to help businesses manage money movement with ease. Whether you are paying a vendor or requesting funds from a partner, our APIs provide a secure and reliable way to handle your financial operations.

With these APIs, you can:

  • Manage Payees: Securely save the details of people or businesses you work with, including their bank information for ACH, Wire, or Braid transfers.
  • Move Money: Create and send payment requests quickly by specifying the amount and the preferred payment method.
  • Track Activity: Search through your transaction history to monitor the status of your payments and keep your records up to date.
Download OpenAPI description
braid.json
braid.yaml
Overview
API Support
support@theropay.io
Languages
Servers
Mock server
https://docs.theropay.co/_mock/theropay/docs/reference/braid
Sandbox Server
https://devapi.theropay.co

Business

Manage your business partners and counterparties. Use these APIs to create and store information about the people or companies you interact with, including their bank details and identity verification.

Operations

Payment

Initiate and handle money movement. This section allows you to create new payment requests, set the transaction amount, and choose the best payment method for your needs.

Operations

Send payment request.

Request

This endpoint allows you to create and send a payment request. A payment request represents a request for a customer or partner to pay a specific amount

Security
Bearer
Body

The details of the payment you want to request.

payeeIdinteger(int32)required
merchantAccountNumberstring or null<= 100 characters
amountnumber(double)[ 0.01 .. 1000000 ]required
currencystring or null

Currency code in ISO 4217 format (default:USD)

paymentMethodTypestringnon-emptyrequired
Enum"STANDARD""SAME_DAY""DOMESTIC_WIRE""INTERNATIONAL_WIRE"
descriptionstring[ 1 .. 500 ] charactersrequired

Description of the payment (max 500 chars)

externalIdstring or null
internalNotestring or null
partnerIdinteger or null(int32)required

Partner ID assigned to your integration

merchantIdinteger(int32)

Merchant ID under which this payment is initiated

partnerPaymentUniqueIdstringrequired

Partner payment identifier

curl -i -X POST \
  https://docs.theropay.co/_mock/theropay/docs/reference/braid/finance/v1/payment_request \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "payeeId": 0,
    "merchantAccountNumber": "string",
    "amount": 0.01,
    "currency": "string",
    "paymentMethodType": "STANDARD",
    "description": "string",
    "externalId": "string",
    "internalNote": "string",
    "partnerId": 0,
    "merchantId": 0,
    "partnerPaymentUniqueId": "string"
  }'

Responses

OK

Transaction

Track and monitor your financial activity. These tools allow you to search through your payment history, check the status of specific transfers, and get detailed information about any transaction.

Operations