Create an ACH Return

{
  "type": "object",
  "description": "If unauthorized activity occurs via ACH, you can create an Inbound ACH Transfer Return and we'll reverse the transaction. You can create an Inbound ACH Transfer return the first two days after receiving an Inbound ACH Transfer.",
  "required": [
    "id",
    "inbound_ach_transfer_transaction_id",
    "reason",
    "status",
    "submission",
    "transaction_id",
    "type"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the Inbound ACH Transfer Return."
    },
    "inbound_ach_transfer_transaction_id": {
      "type": "string",
      "description": "The ID for the Transaction that is being returned."
    },
    "reason": {
      "type": "string",
      "description": "The reason why this transfer will be returned. This is sent to the initiating bank.",
      "enum": [
        "authorization_revoked_by_customer",
        "payment_stopped",
        "customer_advised_unauthorized_improper_ineligible_or_incomplete",
        "representative_payee_deceased_or_unable_to_continue_in_that_capacity",
        "beneficiary_or_account_holder_deceased",
        "credit_entry_refused_by_receiver",
        "duplicate_entry",
        "corporate_customer_advised_not_authorized"
      ]
    },
    "status": {
      "type": "string",
      "description": "The lifecycle status of the transfer.",
      "enum": [
        "pending_submitting",
        "submitted"
      ]
    },
    "submission": {
      "type": "object",
      "description": "After the return is submitted to FedACH, this will contain supplemental details.",
      "required": [
        "submitted_at",
        "trace_number"
      ],
      "properties": {
        "submitted_at": {
          "type": "string",
          "format": "date-time",
          "description": "When the ACH transfer return was sent to FedACH."
        },
        "trace_number": {
          "type": "string",
          "description": "The trace number for the submission."
        }
      }
    },
    "transaction_id": {
      "type": "string",
      "description": "The ID for the transaction refunding the transfer."
    },
    "type": {
      "type": "string",
      "description": "A constant representing the object's type. For this resource it will always be `inbound_ach_transfer_return`.",
      "enum": [
        "inbound_ach_transfer_return"
      ]
    }
  }
}