1. Resources
Cash-In API
  • Introduction
  • Access tokens
  • Environments
  • Errors
  • Contact us
  • Resources
    • Services
    • Invoice Intermediation service
    • Invoice Lifecycle service
    • Debt Collection service
    • Debt Collection process
    • Confirma Software Partner services
  • Authorization
    • Authentication and authorization of the user
    • Validate token
      GET
    • Renew token
      GET
  • Collection & Payment Control
    • Create Collection Cases
      POST
    • Update Collection Receivables
      POST
    • Retrieve Collection Receivables Status
      GET
    • Retrieve Case Batch Status
      GET
    • Retrieve collection case
      GET
    • Retrieve debtor summary
      GET
    • Retrieve list of settlements
      GET
    • Retrieve settlement data
      GET
    • Retrieve list of direct settlements
      GET
    • Retrieve direct settlement data
      GET
    • Retrieve Credit Loss Receivables
      GET
  • Invoice Intermediation
    • Invoice Service
      • Create an invoice
      • Create batch of invoices
      • Create an invoice with seller information
      • List all sales invoices
      • Retrieve invoice delivery information
      • Retrieve invoice status
      • Update an invoice
      • Submit payment for an invoice
      • Retrieve delivery statistics
      • Retrieve received payments
      • Submit update to Finvoice Account
      • Retrieve electronic invoicing contracts
    • Product Management
      • List all products
      • Submit new products
      • Delete an product
    • Customer Management
      • List all customers
      • Submit new customers
      • Update an customer
      • Delete an customer
    • External invoices
      • Retrieve delivery information
      • Retrieve payment information
      • Create an direct payment
      • Submit an invoice action
      • Retrieve status of the agreement
  • Confirma Software Partners
    • Submit new creditor
    • Update creditor
    • Retrieve creditor credentials
    • Retrieve External Agreement Identifiers
    • Retrieve invoice delivery information by seller
    • Send SMS message
  • Document Print Service
    • Create meter reading documents
  • Schemas
    • BatchDataResponse
    • BatchInvoices
    • BatchInvoicesList
    • BatchStatus
    • Case
    • CaseInvoiceExtended
    • CaseList
    • CaseSummary
    • CollectionResponse
    • ContactPerson
    • CreditLossReceivable
    • Creditor
    • CreditorData
    • CreditorDetails
    • CreditorIdentifiers
    • CreditorResponse
    • CreditorUpdateData
    • CreditorUpdateDetails
    • CreditorUpdateResponse
    • CustomParameters
    • Debtor
    • DirectSettlementList
    • DirectSettlementRows
    • DirectSettlements
    • DocumentCustomer
    • DocumentResponse
    • ElectronicInvoicingContracts
    • ErrorMessage
    • ExternalAgreementIdentifiers
    • ExternalAgreementStatusResponse
    • ExternalInvoice
    • ExternalInvoiceActions
    • ExternalInvoiceRows
    • FinvoiceAccountUpdate
    • FinvoiceAccountUpdateResponse
    • IntegrationsAccountingLedgerData
    • IntermediationInvoiceDirectPaymentResponse
    • IntermediationInvoiceDirectPayments
    • IntermediatorInvoice
    • Invoice
    • InvoiceActionResponse
    • InvoicePaymentsResponse
    • InvoicesDeliveryInformation
    • LedgerRowDimensions
    • LedgerRows
    • Ledgers
    • Messages
    • MeterCompany
    • MeterDocument
    • MeterDocumentList
    • MeterReading
    • MeterUsageLocation
    • NxsReceivedPayments
    • OnlineCustomer
    • OnlineCustomerResponse
    • OnlineCustomerUpdateResponse
    • OnlineInvoicePaymentControl
    • OnlineProduct
    • OnlineSalesInvoices
    • PagedSalesInvoicesResponse
    • Payment
    • Receivable
    • ReceivablesList
    • ReceivedPaymentRows
    • ReceivedPayments
    • ReceivedPaymentsResponse
    • RenewResponse
    • SalesAddressDTO
    • SalesInvoice
    • SalesInvoiceBatchResponse
    • SalesInvoicePayment
    • SalesInvoiceResponse
    • SalesInvoiceRow
    • SalesInvoiceUpdate
    • SalesInvoiceUpdateResponse
    • SalesInvoiceWithSellerInfoDTO
    • SalesItemResponse
    • SalesItems
    • SellerInfoDTO
    • Settlement
    • SettlementList
    • SettlementRows
    • SmsData
    • SmsDeliveryReport
    • SmsResponse
    • ValidationResponse
    • ViewOnlineInvoiceDeliveryStats
  1. Resources

Confirma Software Partner services

This section is exclusively available to Confirma Software partners.
The endpoints described here require a partner-level API key with elevated privileges — standard creditor-level access tokens cannot be used to call these endpoints.
Partner services provide the tooling needed to manage creditors programmatically within the Cash-In platform — from onboarding new creditors and maintaining their account details, to monitoring invoice delivery across all creditors in a partner's portfolio and communicating directly with debtors via SMS.
If you are a Confirma Software partner and have not yet received your partner-level API key, contact deployment@cash-in.fi to request access..

Endpoints available to partners#

cashin_partner_services.svg
Endpoints available to partners

Creditor management#

Partners can create and maintain creditor accounts directly through the API, without requiring manual onboarding through Cash-In's deployment team.
Submit new creditor POST
Registers a new creditor in the Cash-In platform. The payload includes the creditor's business details, contact persons, and service configuration.
On success, the creditor is provisioned and their API credentials are returned in the response.
Update creditor POST
Updates the account details of an existing creditor. Use this endpoint to keep creditor contact information, bank account details, or service settings current without requiring manual intervention from Cash-In.

Credential management#

Retrieve creditor credentials GET
Returns the current API credentials for a specified creditor. This is useful when a creditor's access token needs to be retrieved or verified programmatically — for example, when integrating new creditors into a partner's own platform or supporting a creditor whose token has been lost.
Retrieve External Agreement Identifiers GET
Returns the external agreement identifiers associated with a creditor. These identifiers are used to map the creditor's account in Cash-In to the corresponding records in a partner's own system, ensuring consistent reference across integrations.

Delivery monitoring#

Retrieve invoice delivery information by seller GET
Returns invoice delivery information scoped to a specific seller (creditor). Unlike the standard delivery endpoint available to individual creditors, this partner-level endpoint allows a single API call to retrieve delivery data on behalf of any creditor in the partner's portfolio — enabling centralised monitoring of invoice distribution across all managed accounts.

Debtor communication#

Send SMS message POST
Sends an SMS message to a specified recipient. This endpoint is intended for debtor outreach — for example, sending payment reminders or case notifications directly to a debtor's mobile number as part of a collection workflow. Message delivery reports are available in the response.
Previous
Debt Collection process
Next
Authentication and authorization of the user
Built with