​
Overview

The retry endpoint allows you to reattempt a failed transfer that is marked as retriable within a bulk transfer batch. This is useful when transfers fail due to temporary issues like network problems or bank system downtime.

Only transfers with retryable: true in their status can be retried. Non-retriable failures (like invalid account numbers) cannot be retried.

​
Endpoint

POST /bulk-transfers/{batch_id}/transfers/{id}/retry

​
Path Parameters

​
batch_id
string
required

The unique identifier of the bulk transfer batch

​
id
string
required

The unique identifier of the failed transfer to retry

​
Example Request

curl -X POST "https://api.spendjuice.com/bulk-transfers/{batch_id}/transfers/{id}/retry" \
-H "Authorization:  YOUR_API_KEY"

​
Response

​
202 Accepted

Retry request accepted successfully

​
Error Responses

​
Retry Limits

  • Maximum 3 retry attempts per transfer
  • 5-minute wait period between retries
  • 24-hour maximum retry window from initial failure
  • Retries count towards daily transfer limits

​
Status Transitions

  1. Initial failed status: failed with retryable: true
  2. After retry request: processing
  3. Final status:
    • Success: succeeded
    • Failure: failed (may be retriable again)

​
Webhook Events

Monitor these events for retry status:

  • bulk.transfer.retry.started - Retry attempt initiated
  • bulk.transfer.retry.succeeded - Retry completed successfully
  • bulk.transfer.retry.failed - Retry attempt failed

​
Best Practices

  1. Retry Strategy

    • Implement exponential backoff between retries
    • Track retry attempt count
    • Consider time of day for retries
    • Monitor success rates by failure reason

  2. Error Handling

    • Log all retry attempts
    • Track retry outcomes
    • Handle webhook notifications
    • Monitor retry limits

  3. User Communication

    • Notify users of retry status
    • Provide clear error messages
    • Suggest alternative actions for non-retriable failures
    • Set expectations for processing time

Need Help?

For retry-related assistance: