Split requests

Create split request

Create a new split request for a merchant transaction.<br> Managing financial transactions often requires dividing a single transaction into multiple parts for accurate record-keeping and reporting. The split transaction feature addresses this need by allowing you to split a transaction into different categories or assign portions to various accounts. This functionality is particularly useful for handling shared expenses, allocating costs across different budget categories, or separating business and personal expenses. When a split request is created, it's created with a PENDING status. Before you request a split, make sure the merchant transaction is already in the WAITING_SPLIT status.<br> This endpoint generates a Merchant transaction created event.

post/v1/transactions/{merchantTransactionId}/split

Request

  • Base URL
    https://sandbox.pismolabs.io/sellers
  • URL
    https://sandbox.pismolabs.io/sellers/v1/transactions/{merchantTransactionId}/split
  • Auth
    HTTP bearer

Path parameters

merchantTransactionIdinteger required

Merchant transaction ID

Headers

Authorizationstring required

Authorization token

Request body

event_datestring datetime required

Event datetime. The datetime format follows the ISO 8601 format (UTC).

installmentsinteger required

Number of installments

processing_codestring required

Processing code.<br> For more information, refer to Processing codes.

Example request

{
  "event_date": "2023-01-01T12:00:00Z",
  "installments": 1,
  "processing_code": "999999",
  "definitions": [
    {
      "merchant_id": 1,
      "amount": 100,
      "amount_percentage": 0.25,
      "processing_code": "999999",
      "transaction_status": "SCHEDULED"
    }
  ]
}

Response

Successfully create split requests

idinteger

Marketplace ID

Changes

No recorded changes to this operation across all 1 revision of this API.