Enable payment methods for an organization

Overview

Tesouro enables payment methods for an organization as part of onboarding:

card becomes active for receiving payments once the organization is onboarded to Tesouro payments.
ach is enabled by Tesouro for sending payments. Contact support to enable it for an organization.

All API calls mentioned on this page require a partner access token.

Get enabled payment methods

To get the payment methods that are enabled for an organization, call GET /entities/{entity_id}/payment-methods:

curl -X GET 'https://api.sandbox.tesouro.com/finops/v1/entities/3fa85f64...3f66afa6/payment-methods' \
     -H 'X-Finops-Version: 2025-06-23' \
     -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

The response contains the display name and code of each payment method, the payment direction (send or receive), and the payment method’s status (active or inactive).

{
  "data": [
    {
      "name": "Card payments",
      "type": "card",
      "status": "active",
      "direction": "receive"
    },
    {
      "name": "ACH Payments",
      "type": "ach",
      "status": "active",
      "direction": "send"
    }
  ]
}

Confirm card payments

To confirm that an organization can receive card payments, call PUT /entities/{entity_id}/payment-methods with card in the payment_methods_receive list:

curl -X PUT 'https://api.sandbox.tesouro.com/finops/v1/entities/3fa85f64...3f66afa6/payment-methods' \
     -H 'X-Finops-Version: 2025-06-23' \
     -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
     -H 'Content-Type: application/json' \
     -d '{
       "payment_methods_receive": [
         "card"
       ]
     }'

If the organization is onboarded, the response lists the active card method:

{
  "data": [
    {
      "name": "Card payments",
      "type": "card",
      "status": "active",
      "direction": "receive"
    }
  ]
}

The request returns 409 Conflict in these cases:

The organization is not onboarded to Tesouro payments yet.
The request includes ach. Contact support to enable ACH instead.
The request includes card in payment_methods_send. Cards can only receive payments.

Payment method codes

The following table contains the payment method codes used by the /entities/{entity_id}/payment-methods endpoints.

Name	Code	Direction
Credit and debit cards	`card`	`receive`
Tap on phone	`card`	`receive`
ACH	`ach`	`send`

Getting started

Authentication

Roles & permissions

Manage organizations

Common objects

Accounts payable

Accounts receivable

Expense management

Payments

Advanced

Accounting integrations

Enable payment methods for an organization

Overview

Get enabled payment methods

Confirm card payments

Payment method codes

​Overview

​Get enabled payment methods

​Confirm card payments

​Payment method codes

Overview

Get enabled payment methods

Confirm card payments

Payment method codes