{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Credit Agency Configuration","siteUrl":"https://docs.peachfinance.com","description":"API and product documentation for Peach Finance, a lending-as-a-service platform.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"credit-agency-configuration","__idx":0},"children":["Credit Agency Configuration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each credit bureau connection requires a Credit Agency record in Peach. This configuration controls how files are generated, named, and transmitted."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credit-agency-object","__idx":2},"children":["Credit Agency Object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a credit agency using the API endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /companies/{companyId}/credit-agencies"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"agencyName\": \"equifax\",\n  \"country\": \"US\",\n  \"dataFormat\": \"metro2\",\n  \"nameFilePerAgencyConvention\": true,\n  \"fileNamePrefix\": \"MYPREFIX\",\n  \"uploadFrequency\": \"monthly\",\n  \"specificDays\": [1],\n  \"useLoanExternalId\": true,\n  \"sftpHostname\": \"sftp.equifax.com:22\",\n  \"sftpUsername\": \"yourcompany\",\n  \"sftpPassword\": \"encrypted_password\",\n  \"sftpCdDir\": \"/inbound\",\n  \"encryptionMethod\": \"GPG\",\n  \"publicKey\": \"-----BEGIN PGP PUBLIC KEY BLOCK-----...\",\n  \"enrollExistingLoans\": false,\n  \"copyKeysFrom\": \"CA-XXXX-XXXX\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"field-reference","__idx":3},"children":["Field Reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agencyName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Credit bureau identifier (see Agency Name Values below)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Country code (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dataFormat"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data format (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metro2"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nameFilePerAgencyConvention"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use bureau-specific file naming convention"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileNamePrefix"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File name prefix (required for Experian when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nameFilePerAgencyConvention=true"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadFrequency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upload frequency (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["monthly"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["weekly"]},", etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["specificDays"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specific days of month for upload (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[1]"]}," for 1st of month)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["useLoanExternalId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use loan's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalId"]}," as Consumer Account Number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpHostname"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SFTP server hostname with optional port"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpUsername"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SFTP username"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpPassword"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SFTP password (for password authentication)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpAccessMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication method: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usernamePassword"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keys"]}," (defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usernamePassword"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpCdDir"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Directory to navigate to before upload"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["encryptionMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Encryption method (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GPG"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["publicKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PGP public key for file encryption"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enrollExistingLoans"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automatically enroll existing active loans for credit reporting with this agency (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["copyKeysFrom"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Credit Agency ID to copy SSH keys from (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA-XXXX-XXXX"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"agency-name-values","__idx":4},"children":["Agency Name Values"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Bureau"},"children":["Bureau"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["equifax"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equifax"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["experian"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Experian"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transUnion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TransUnion"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["innovis"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Innovis"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sftp-configuration","__idx":5},"children":["SFTP Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpHostname"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SFTP server hostname (with optional port)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For lender-upload"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpUsername"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SFTP username"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For lender-upload"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpPassword"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SFTP password (encrypted)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For password auth"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpAccessMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usernamePassword"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keys"]}," (defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usernamePassword"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpCdDir"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Directory to change to before upload"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpSSHPeachPublicKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Peach's public key (generated)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For key auth"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpSSHPeachPrivateKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Peach's private key (generated)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For key auth"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["copyKeysFrom"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Credit Agency ID to copy SSH keys from"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key-Based Authentication:"]}," When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sftpAccessMethod"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["keys"]},", Peach generates an SSH key pair. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["copyKeysFrom"]}," field allows you to reuse keys from an existing Credit Agency configuration instead of generating new ones."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"encryption-configuration","__idx":6},"children":["Encryption Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["encryptionMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currently only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GPG"]}," supported"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["publicKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PGP public key for file encryption"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When encryption is enabled:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Metro 2 file is generated in plain text"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["File is encrypted using the provided public key"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Encrypted file is uploaded to SFTP"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"file-naming-options","__idx":7},"children":["File Naming Options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard Naming"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nameFilePerAgencyConvention: false"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{COMPANY_LEGAL_NAME}{COMPANY_ID}{AGENCY_NAME}{YYYYMMDD}.txt\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACMELENDINGLLCCPYL69X5Z1EQUIFAX20260101.txt"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Equifax Convention"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nameFilePerAgencyConvention: true"]},", Equifax): Same as standard naming."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Experian Convention"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nameFilePerAgencyConvention: true"]},", Experian):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{FILE_NAME_PREFIX}.{MMDDYYYY}.txt\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MKFRT.01012026.txt"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileNamePrefix"]}," to be set."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TransUnion Convention"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nameFilePerAgencyConvention: true"]},", TransUnion): Same as standard naming."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-identifier-configuration","__idx":8},"children":["Account Identifier Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Setting"},"children":["Setting"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Behavior"},"children":["Behavior"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["useLoanExternalId: true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Uses loan's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalId"]}," as Consumer Account Number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["useLoanExternalId: false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Uses loan's Peach Public ID (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LN-JFU3-ER3S"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["useLoanExternalId"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," but the loan has no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalId"]},", falls back to Public ID."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"loan-enrollment-options","__idx":9},"children":["Loan Enrollment Options"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Setting"},"children":["Setting"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Behavior"},"children":["Behavior"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enrollExistingLoans: true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Automatically enrolls all existing active loans for credit reporting with this agency when the agency is created"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enrollExistingLoans: false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only new loans activated after agency creation will be enrolled (default)"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enrollExistingLoans"]}," flag is only evaluated at agency creation time. It does not retroactively enroll loans if set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," on an update."]}]}]},"headings":[{"value":"Credit Agency Configuration","id":"credit-agency-configuration","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Credit Agency Object","id":"credit-agency-object","depth":2},{"value":"Field Reference","id":"field-reference","depth":2},{"value":"Agency Name Values","id":"agency-name-values","depth":2},{"value":"SFTP Configuration","id":"sftp-configuration","depth":2},{"value":"Encryption Configuration","id":"encryption-configuration","depth":2},{"value":"File Naming Options","id":"file-naming-options","depth":2},{"value":"Account Identifier Configuration","id":"account-identifier-configuration","depth":2},{"value":"Loan Enrollment Options","id":"loan-enrollment-options","depth":2}],"frontmatter":{"seo":{"title":"Credit Agency Configuration"}},"lastModified":"2026-05-01T14:33:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/credit-reporting/credit-agency-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}