Skip to Content

PaymentAccountsApi

All URIs are relative to https://business.apis.kesk.app/v1 

MethodHTTP requestDescription
createPaymentAccountPOST /payment-accountsCreate a new payment account for receiving payouts.
listPaymentAccountsGET /payment-accountsList all payment accounts accessible to the authenticated user.
updatePaymentAccountPUT /payment-accounts/{id}Update an existing payment account’s details.

createPaymentAccount

PaymentAccountResponse createPaymentAccount(PaymentAccountInput)

Create a new payment account for receiving payouts.

Registers a new bank account or payment account with the specified details. Validates account information based on the account type (IBAN, US, CA, etc.) before creation.

Parameters

NameTypeDescriptionNotes
PaymentAccountInputPaymentAccountInputPayment account details including name, type, and region-specific account information.

Return type

PaymentAccountResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

listPaymentAccounts

PaginatedResponse_PaymentAccountResponse listPaymentAccounts(page, per_page)

List all payment accounts accessible to the authenticated user.

Returns payment accounts owned by the user or associated with vendors they manage. Managers can see all vendor payment accounts, while regular users see only their own.

Parameters

NameTypeDescriptionNotes
pageInteger[optional] [default to null]
per_pageInteger[optional] [default to null]

Return type

PaginatedResponse_PaymentAccountResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

updatePaymentAccount

PaymentAccountResponse updatePaymentAccount(id, PaymentAccountInput)

Update an existing payment account’s details.

Modifies the account information for a payment account owned by the user or their managed vendors. All account details including type and account-specific fields can be updated.

Parameters

NameTypeDescriptionNotes
idLongThe unique identifier of the payment account to update.[default to null]
PaymentAccountInputPaymentAccountInputUpdated payment account details including name, type, and account information.

Return type

PaymentAccountResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8