Update Bulk Transfer

​

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.

​

Endpoint

POST /bulk-transfers/{id}/transfers

​

Request Parameters

​

Example Request

curl -X POST "https://api.spendjuice.com/bulk-transfers/88dbcb86-5025-4ac9-9750-4aa5a77a723c/transfers" \
-H "Authorization: Bearer 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

​

Validation Rules

​

Error Handling

​

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