Edit the payment processor config for an existing account

PUT /accounts/{account_id}/payment_processor_config

Toggle autopay or change the payment processor / bank information for a given account.

Body

Edit Payment Processor Config

  • ach object

    ACH processing configuration.

    Hide ach attributes Show ach attributes object
    • payment_processor_name string Required

      Indicates the active payment processor whose configuration will be used for ACH/Debit card payments made from the account.

      Values are NONE, REPAY, DWOLLA, MODERN_TREASURY, or CANOPY_NACHA. Default value is NONE.

    • Sensitive bank information will be stored as a secured token for payments in place of the raw account details.

      Hide repay_config attributes Show repay_config attributes object
      • repay_check_type string Required

        Type of checking account: Personal or Business.

        Values are PERSONAL or BUSINESS.

      • repay_account_type string Required

        Type of account: Savings or Checking.

        Values are SAVINGS or CHECKING.

      • repay_transit_number string Required

        Transit number is a nine-digit code based on the U.S. Bank location where your account was opened.

      • repay_account_number string Required

        Account number is an eight to ten digit number that identifies a specific account.

      • repay_name_on_check string Required

        Account holder's name as it appears on the account.

    • Dwolla account verified and tokenized using Plaid.

      Hide dwolla_config attribute Show dwolla_config attribute object
    • Store bank details or a secured token for payments.

      Hide modern_treasury_config attributes Show modern_treasury_config attributes object
      • name string Required

        Account holder's name as it appears on the account.

      • Account number is an eight to ten digit number that identifies a specific account.

      • Type of account: Savings or Checking.

        Values are SAVINGS or CHECKING.

      • Routing number is a nine-digit code based on the U.S. Bank location where your account was opened.

      • Plaid processor token retrieved from Plaid Link.

    • Canopy will create a NACHA file for each borrower ACH payment to be sent to your bank for ACH execution.

      Hide canopy_nacha_config attributes Show canopy_nacha_config attributes object
      • bank_routing_number string Required

        Routing number is a nine-digit code based on the U.S. Bank location where your account was opened.

      • bank_account_number string Required

        Account number is an eight to ten digit number that identifies a specific account.

  • Debit processing configuration.

    Hide debit_card attributes Show debit_card attributes object
    • payment_processor_name string Required

      Indicates the active payment processor whose configuration will be used for payments made from the account. If NONE, Canopy will not trigger payments to an external payment processor when they occur.

      Values are NONE, REPAY, or AUTHORIZE_NET. Default value is NONE.

    • Sensitive debit card information will be stored as a secured token for payments in place of the raw account details.

      Hide repay_config attributes Show repay_config attributes object
      • repay_card_number string Required

        16 digit debit card number.

        Minimum length is 16, maximum length is 16. Format should match the following pattern: ^[0-9]{16}$.

      • repay_exp_date string Required

        The card expiration date in the format MMYY.

        Minimum length is 4, maximum length is 4. Format should match the following pattern: ^[0-9]{4}$.

      • repay_name_on_card string Required

        The card holder's name as it appears on the card.

      • repay_street string Required

        The card holder's billing street address.

      • repay_zip string Required

        The card holder's billing zip code.

    • Sensitive credit or debit card information will be stored as a secured token for payments in place of the raw account details. Note: This leverages credit card payment gateways, and Canopy cannot differentiate between credit or debit cards used in this payment integration. See authorize.net payment profiles for further details.

      Hide authorize_net_config attributes Show authorize_net_config attributes object
      • card_number string Required

        16 digit debit card number.

        Minimum length is 16, maximum length is 16. Format should match the following pattern: ^[0-9]{16}$.

      • The card expiration month.

        Minimum length is 2, maximum length is 2. Format should match the following pattern: ^[0-9]{2}$.

      • The card expiration year.

        Minimum length is 4, maximum length is 4. Format should match the following pattern: ^[0-9]{4}$.

      • cvv string

        The card cvv, i.e. security code.

        Minimum length is 3, maximum length is 4.

  • Credit processing configuration.

    Hide credit_card attributes Show credit_card attributes object
    • payment_processor_name string Required

      Indicates the active payment processor whose configuration will be used for Credit card payments made from the account.

      Values are NONE or CHECKOUT. Default value is NONE.

    • Hide checkout_config attributes Show checkout_config attributes object
  • Indicates whether autopay is enabled for this account. Currently, autopay is triggered 1 day prior to a payment due date. If default_payment_processor is set to NONE, autopay will not be triggered for account regardless of this field's value.

    Default value is false.

  • Configures the payment processor to be used for manual or autopay payments. This cannot be set to a value different from NONE if no valid ACH or Debit Card configs are provided.

    Values are ACH, DEBIT_CARD, CREDIT_CARD, or NONE. Default value is NONE.

Responses

  • Payment Processor Configuration Updated

    Hide response attributes Show response attributes object
    • ach object

      ACH processing configuration.

      Hide ach attributes Show ach attributes object
      • payment_processor_name string Required

        Indicates the active payment processor whose configuration will be used for ACH/Debit card payments made from the account.

        Values are NONE, REPAY, DWOLLA, MODERN_TREASURY, or CANOPY_NACHA. Default value is NONE.

      • repay_config object | null
        Hide repay_config attributes Show repay_config attributes object | null
        • ach_token string | null

          The tokenized ACH details.

        • last_four string | null

          The last four digits of the account number

      • dwolla_config object | null
        Hide dwolla_config attributes Show dwolla_config attributes object | null
        • ach_token string | null

          The tokenized ACH details.

        • last_four string | null

          The last four digits of the account number

      • Hide modern_treasury_config attributes Show modern_treasury_config attributes object | null
        • ach_token string | null

          The tokenized ACH details.

        • last_four string | null

          The last four digits of the account number

      • Canopy will create a NACHA file for each borrower ACH payment to be sent to your bank for ACH execution.

        Hide canopy_nacha_config attributes Show canopy_nacha_config attributes object
        • bank_routing_number string Required

          Routing number is a nine-digit code based on the U.S. Bank location where your account was opened.

        • bank_account_number string Required

          Account number is an eight to ten digit number that identifies a specific account.

    • Debit processing configuration.

      Hide debit_card attributes Show debit_card attributes object
      • payment_processor_name string Required

        Indicates the active payment processor whose configuration will be used for Debit card payments made from the account.

        Values are NONE, REPAY, or AUTHORIZE_NET. Default value is NONE.

      • repay_config object | null
        Hide repay_config attributes Show repay_config attributes object | null
        • card_token string | null

          The tokenized card details.

        • last_four string | null

          The last four digits of the card number

      • Sensitive credit or debit card information will be stored as a secured token for payments in place of the raw account details. Note: This leverages credit card payment gateways, and Canopy cannot differentiate between credit or debit cards used in this payment integration. See authorize.net payment profiles for further details.

        Hide authorize_net_config attributes Show authorize_net_config attributes object
    • Credit processing configuration.

      Hide credit_card attributes Show credit_card attributes object
      • payment_processor_name string Required

        Indicates the active payment processor whose configuration will be used for Credit card payments made from the account.

        Values are NONE or CHECKOUT. Default value is NONE.

      • checkout_config object | null
        Hide checkout_config attributes Show checkout_config attributes object | null
        • A Checkout.com payment source id or customer id.

        • The tokenized card number.

        • last_four string | null

          The last 4 digits of the card number.

        • expires_on string | null

          Expiration time for the card token.

    • Indicates whether autopay is enabled for this account. Currently, autopay is triggered 1 day prior to a payment due date. If default_payment_processor is set to NONE, autopay will not be triggered for account regardless of this field's value.

      Default value is false.

    • Configures the payment processor to be used for manual or autopay payments. This cannot be set to a value different from NONE if no valid ACH or Debit Card configs are provided.

      Values are ACH, DEBIT_CARD, CREDIT_CARD, or NONE. Default value is NONE.

  • Unauthorized.

  • Forbidden.

  • Invalid input

  • Too many requests.

  • Unexpected Error.

PUT /accounts/{account_id}/payment_processor_config
curl \
 -X PUT https://sandbox-api.canopyservicing.com/accounts/{account_id}/payment_processor_config \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"ach":{"payment_processor_name":"REPAY","repay_config":{"repay_check_type":"PERSONAL","repay_account_type":"CHECKING","repay_transit_number":"999999992","repay_account_number":"987654321","repay_name_on_check":"Lucille Bluth"},"dwolla_config":{"dwolla_plaid_token":"processor-sandbox-161c86dd-d470-47e9-a741-d381c2b2cb6f"},"modern_treasury_config":{"name":"Lucille Bluth","account_number":"987654321","account_type":"CHECKING","routing_number":"999999992","plaid_processor_token":"processor-987654321"},"canopy_nacha_config":{"bank_routing_number":"999999992","bank_account_number":"987654321"}},"debit_card":{"payment_processor_name":"REPAY","repay_config":{"repay_card_number":"4622941000000005","repay_exp_date":"0619","repay_name_on_card":"John Doe","repay_street":"1234 Main Street","repay_zip":"85281"},"authorize_net_config":{"card_number":"4622941000000005","expiry_month":"string","expiry_year":"string","cvv":"string"}},"credit_card":{"payment_processor_name":"CHECKOUT","checkout_config":{"source_id":"cus_6artgoevd77u7ojah2wled32s","card_token":"string","card_number":"string","expiry_month":"string","expiry_year":"string","cvv":"string"}},"autopay_enabled":true,"default_payment_processor_method":"ACH"}'
Request example
{
  "ach": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "repay_check_type": "PERSONAL",
      "repay_account_type": "CHECKING",
      "repay_transit_number": "999999992",
      "repay_account_number": "987654321",
      "repay_name_on_check": "Lucille Bluth"
    },
    "dwolla_config": {
      "dwolla_plaid_token": "processor-sandbox-161c86dd-d470-47e9-a741-d381c2b2cb6f"
    },
    "modern_treasury_config": {
      "name": "Lucille Bluth",
      "account_number": "987654321",
      "account_type": "CHECKING",
      "routing_number": "999999992",
      "plaid_processor_token": "processor-987654321"
    },
    "canopy_nacha_config": {
      "bank_routing_number": "999999992",
      "bank_account_number": "987654321"
    }
  },
  "debit_card": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "repay_card_number": "4622941000000005",
      "repay_exp_date": "0619",
      "repay_name_on_card": "John Doe",
      "repay_street": "1234 Main Street",
      "repay_zip": "85281"
    },
    "authorize_net_config": {
      "card_number": "4622941000000005",
      "expiry_month": "string",
      "expiry_year": "string",
      "cvv": "string"
    }
  },
  "credit_card": {
    "payment_processor_name": "CHECKOUT",
    "checkout_config": {
      "source_id": "cus_6artgoevd77u7ojah2wled32s",
      "card_token": "string",
      "card_number": "string",
      "expiry_month": "string",
      "expiry_year": "string",
      "cvv": "string"
    }
  },
  "autopay_enabled": true,
  "default_payment_processor_method": "ACH"
}
Request examples
{
  "ach": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "repay_check_type": "PERSONAL",
      "repay_account_type": "CHECKING",
      "repay_transit_number": "999999992",
      "repay_account_number": "987654321",
      "repay_name_on_check": "Lucille Bluth"
    },
    "dwolla_config": {
      "dwolla_plaid_token": "processor-sandbox-161c86dd-d470-47e9-a741-d381c2b2cb6f"
    },
    "modern_treasury_config": {
      "name": "Lucille Bluth",
      "account_number": "987654321",
      "account_type": "CHECKING",
      "routing_number": "999999992",
      "plaid_processor_token": "processor-987654321"
    },
    "canopy_nacha_config": {
      "bank_routing_number": "999999992",
      "bank_account_number": "987654321"
    }
  },
  "debit_card": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "repay_card_number": "4622941000000005",
      "repay_exp_date": "0619",
      "repay_name_on_card": "John Doe",
      "repay_street": "1234 Main Street",
      "repay_zip": "85281"
    },
    "authorize_net_config": {
      "card_number": "4622941000000005",
      "expiry_month": "string",
      "expiry_year": "string",
      "cvv": "string"
    }
  },
  "credit_card": {
    "payment_processor_name": "CHECKOUT",
    "checkout_config": {
      "source_id": "cus_6artgoevd77u7ojah2wled32s",
      "card_token": "string",
      "card_number": "string",
      "expiry_month": "string",
      "expiry_year": "string",
      "cvv": "string"
    }
  },
  "autopay_enabled": true,
  "default_payment_processor_method": "ACH"
}
Response examples (200)
{
  "ach": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "ach_token": "string",
      "last_four": "string"
    },
    "dwolla_config": {
      "ach_token": "string",
      "last_four": "string"
    },
    "modern_treasury_config": {
      "ach_token": "string",
      "last_four": "string"
    },
    "canopy_nacha_config": {
      "bank_routing_number": "999999992",
      "bank_account_number": "987654321"
    }
  },
  "debit_card": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "card_token": "string",
      "last_four": "string"
    },
    "authorize_net_config": {
      "customer_profile_id": "527262",
      "customer_payment_profile_ids": [
        "86"
      ]
    }
  },
  "credit_card": {
    "payment_processor_name": "CHECKOUT",
    "checkout_config": {
      "source_id": "cus_6artgoevd77u7ojah2wled32s",
      "card_token": "string",
      "last_four": "string",
      "expires_on": "string"
    }
  },
  "autopay_enabled": true,
  "default_payment_processor_method": "ACH"
}
Response examples (200)
{
  "ach": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "ach_token": "string",
      "last_four": "string"
    },
    "dwolla_config": {
      "ach_token": "string",
      "last_four": "string"
    },
    "modern_treasury_config": {
      "ach_token": "string",
      "last_four": "string"
    },
    "canopy_nacha_config": {
      "bank_routing_number": "999999992",
      "bank_account_number": "987654321"
    }
  },
  "debit_card": {
    "payment_processor_name": "REPAY",
    "repay_config": {
      "card_token": "string",
      "last_four": "string"
    },
    "authorize_net_config": {
      "customer_profile_id": "527262",
      "customer_payment_profile_ids": [
        "86"
      ]
    }
  },
  "credit_card": {
    "payment_processor_name": "CHECKOUT",
    "checkout_config": {
      "source_id": "cus_6artgoevd77u7ojah2wled32s",
      "card_token": "string",
      "last_four": "string",
      "expires_on": "string"
    }
  },
  "autopay_enabled": true,
  "default_payment_processor_method": "ACH"
}