{ "NOTE" : "THIS OBJECT IS NOT SUPPORTED IN THE CURRENT API VERSION", "note" : "this file is for future reference only!", "type" : "object", "title" : "Batch Transfer", "name" : "batch_transfer", "description" : "PREVIEW: A transfer batch contains multiple transfers which are processed asynchronously.", "required" : ["account_id", "external_uid"], "properties" : { "id" : { "$ref" : "./base_types/base_types.json#definitions/id" }, "external_uid" : { "$ref" : "./base_types/base_types.json#definitions/external_uid" }, "account_id" : { "$ref" : "./base_types/base_types.json#definitions/account_id" }, "user_id" : { "$ref" : "./base_types/base_types.json#definitions/user_id" }, "sepa_credit_transfers" : { "description" : "SEPA credit transfers to process", "type" : "array", "items" : { "type" : "object", "properties" : { "$ref" : "./sepa_credit_transfer.json#properties" } } }, "internal_transfers" : { "description" : "Interal transfers to process", "type" : "array", "items" : { "type" : "object", "properties" : { "$ref" : "./internal_transfer.json#properties" } } }, "sepa_credit_transfer_ids" : { "description" : "ids of successfully executed SEPA credit transfers", "type" : "array", "items" : { "$ref" : "./base_types/base_types.json#definitions/id" } }, "internal_transfer_ids" : { "description" : "ids of successfully executed internal transfers", "type" : "array", "items" : { "$ref" : "./base_types/base_types.json#definitions/id" } }, "sepa_credit_transfer_errors" : { "description" : "contains a list of errors encountered in nested debits contained in this batch. Transfers are identified by external_uid contained in the original transfer json", "type" : "array", "items" : { "type" : "object", "properties" : { "external_uid" : { "type" : "string" }, "error" : { "type" : "object", "properties" : { "$ref" : "./error.json#properties" } } } } }, "internal_transfer_errors" : { "description" : "contains a list of errors encountered in nested debits contained in this batch. Transfers are identified by external_uid contained in the original transfer json", "type" : "array", "items" : { "type" : "object", "properties" : { "external_uid" : { "type" : "string" }, "error" : { "type" : "object", "properties" : { "$ref" : "./error.json#properties" } } } } }, "transfers_count" : { "description" : "count of transfers (internal and sepa) transactions received in this batch", "readOnly" : true, "type" : "integer" }, "state" : { "description" : "State of the batch operation. received: We received the batch | processing: Batch is currently being processed | failure: An error occurred during execution of the batch. In this case you should check the transfers. | success: Batch execution has been completed.", "enum" : [ "received", "processing", "success", "failure" ], "readOnly" : true, "type" : "string" }, "success_url" : { "description" : "Url receiving a POST with the batch object after processing is finished.", "type" : "string", "format" : "uri" }, "created_at" : { "$ref" : "./base_types/base_types.json#definitions/created_at" }, "updated_at" : { "$ref" : "./base_types/base_types.json#definitions/updated_at" } }, "links" : [ { "rel" : "self", "href" : "batch_transfers/{id}" }, { "rel" : "instances", "href" : "batch_transfers", "properties" : { "filter[account_ids]" : { "title" : "Find transfers belonging to the given account ids. Single id or multiple ids comma-separated.", "format" : "date-time", "type" : "string" }, "filter[created_at_from]" : { "title" : "Creation date filter from >= date", "format" : "date-time", "type" : "string" }, "filter[created_at_to]" : { "title" : "Creation date filter to <= date", "format" : "date-time", "type" : "string" }, "filter[states]" : { "title" : "Filter by single or multiple csv delimited states", "enum" : [ "received", "processing", "success", "failure" ], "type" : "string" }, "page" : { "title" : "Page", "description" : "In paginated results set the page to look for", "type" : "integer" }, "per_page" : { "title" : "Per page", "description" : "Results per page. Default is 10, max is 100", "type" : "integer" }, "sort" : { "title" : "Sort", "enum" : [ "ASC", "DESC" ], "description" : "Sort the results in ASC or DESC", "type" : "string" } } }, { "rel" : "create", "href" : "batch_transfers", "method" : "POST" } ] }