​
Overview

The Update Bulk Transfer endpoint allows you to add transfers to an existing bulk transfer batch. Use this endpoint to populate your bulk transfer with individual payment instructions before execution.

Before adding transfers:

  • Ensure the bulk transfer is in created status
  • Verify the batch hasn’t expired
  • Check that you haven’t exceeded maximum transfer limits

​
Endpoint

POST /bulk-transfers/{id}/transfers

​
Request Parameters

​
id
string
required

The unique identifier of the bulk transfer to update

​
items
array
required

Array of transfer items to add to the batch

​
Example Request

curl -X POST "https://api.spendjuice.com/bulk-transfers/88dbcb86-5025-4ac9-9750-4aa5a77a723c/transfers" \
-H "Authorization:  YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "items": [
    {
      "amount": 100000,
      "beneficiary": {
        "account_name": "Rodrigo Kerluke",
        "account_number": "1111111111",
        "bank_code": "101",
        "bank_name": "McKenzie Bank",
        "routing_number": "111000038",
        "type": "bank_account",
        "currency": "USD",
        "save_beneficiary": true
      },
      "destination_currency": "USD",
      "source_currency": "USD",
      "reference": "transfer-ref-001",
      "reason": "Monthly salary payment"
    }
  ]
}'

​
Response Format

​
data
array

Array of created transfer items

​
Validation Rules

​
Error Handling

​
invalid_status
error

Bulk transfer is not in editable state

  • Status code: 400
  • Must be in created status
​
batch_full
error

Maximum number of transfers reached

  • Status code: 400
  • Remove existing transfers first
​
validation_error
error

Invalid transfer parameters

  • Status code: 422
  • Check error details for specific fields

​
Best Practices

  1. Batch Organization

    • Group similar transfers together
    • Use consistent currencies when possible
    • Include clear references and descriptions
    • Validate beneficiary details before adding

  2. Error Management

    • Implement proper error handling
    • Validate transfers before submission
    • Keep track of failed additions
    • Retry failed transfers with corrected data

  3. Performance

    • Add transfers in reasonable batch sizes
    • Monitor rate limits
    • Handle timeouts appropriately
    • Log all operations

Next Steps

After adding transfers: