Skip to main content
PATCH
/
batches
/
{id}
Update Batch Payment
curl --request PATCH \
  --url https://api.synctera.com/v2/batches/{id} \
  --header 'Content-Type: application/json' \
  --data '{
  "batched_transfer_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "status": "INITIATED",
  "tenant": "abcdef_ghijkl"
}'
{
  "amount": 123,
  "batch_payment_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "batched_transfer_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "creation_time": "2010-05-06T12:23:34.321Z",
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "payment_rail": "<string>",
  "payment_rail_transfer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "INITIATED",
  "tenant": "abcdef_ghijkl",
  "transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Path Parameters

​
id
string<uuid>
required

The unique resource identifier

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Body

application/json

Attributes of the Batch Payment for udpate

​
batched_transfer_ids
string<uuid>[]

The IDs of the transfers that are part of the batch. These values can be modified by the client before the batch is in a terminal status.

​
status
enum<string>

The status of a Batch

Available options:
INITIATED,
PENDING_APPROVAL,
PENDING_PAYMENT,
COMPLETED,
CANCELLED,
DECLINED,
RETURNED
​
tenant
string

The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.

Example:

"abcdef_ghijkl"

Response

Successful update of a Batch Payment

A Batch Payment is a collection of transfers that are processed together. These transfers represent a new transfer on the ledger.

​
amount
integer
required

The total amount of the batch transfer.

​
batch_payment_template_id
string<uuid>
required

The ID of the batch Payment template that was used to create the batch.

​
batched_transfer_ids
string<uuid>[]
required

The IDs of the transfers that are part of the batch. These values can be modified by the client before the batch is in a terminal status.

​
creation_time
string<date-time>
required
Example:

"2010-05-06T12:23:34.321Z"

​
id
string<uuid>
required
Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

​
last_updated_time
string<date-time>
required
Example:

"2010-05-06T12:23:34.321Z"

​
status
enum<string>
required

The status of a Batch

Available options:
INITIATED,
PENDING_APPROVAL,
PENDING_PAYMENT,
COMPLETED,
CANCELLED,
DECLINED,
RETURNED
​
payment_rail
string

The payment rail that was used to process the batch.

​
payment_rail_transfer_id
string<uuid>

The ID of the payment rail transfer that was used to process the batch.

​
tenant
string

The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.

Example:

"abcdef_ghijkl"

​
transaction_id
string<uuid>

The transaction ID of the batch which represents a transaction on the ledger.