action increase_create_an_ach_return {
  label: "Create an ACH Return"
  provider: increase
  method: POST
  path: "/inbound_ach_transfer_returns"
  encoding: json
  input: {
    type: "object"
    required: ["reason", "transaction_id"]
    properties: {
      reason: {
        type: "string"
        description: "The reason why this transfer will be returned. The most usual return codes are `payment_stopped` for debits and `credit_entry_refused_by_receiver` for credits."
        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"]
      }
      transaction_id: {
        type: "string"
        description: "The transaction identifier of the Inbound ACH Transfer to return to the originating financial institution."
      }
    }
  }
  output: {
    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"]
      }
    }
  }
}