{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml","oas-api/index.yaml":"oas-api/index.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab","openapi-code-sample","json-schema"]},"type":"markdown"},"seo":{"title":"Rent Surcharge","description":"The Rent Surcharge lets qualified landlords charge renters a fee for card payments under the Visa Rent Payment Program. Covers requirements and API usage.","siteUrl":"https://docs.finix.com/","llmstxt":{"hide":false,"sections":[{"title":"Getting Started","includeFiles":["guides/getting-started/**/*.md"],"excludeFiles":[]},{"title":"Online Payments","includeFiles":["guides/online-payments/**/*.md"],"excludeFiles":["guides/online-payments/payment-features/fsa-hsa-non-healthcare-mcc.md"]},{"title":"In-Person Payments","includeFiles":["guides/in-person-payments/**/*.md"],"excludeFiles":[]},{"title":"Subscriptions","includeFiles":["guides/subscriptions/**/*.md"],"excludeFiles":[]},{"title":"After the Payment","includeFiles":["guides/subscriptions/after-the-payment/**/*.md"],"excludeFiles":[]},{"title":"Managing Operations","includeFiles":["guides/managing-operations/**/*.md"],"excludeFiles":[]},{"title":"Platform Payments","includeFiles":["guides/platform-payments/**/*.md"],"excludeFiles":[]},{"title":"Payouts","includeFiles":["guides/payouts/**/*.md"],"excludeFiles":[]},{"title":"Developers","includeFiles":["additional-resources/developers/**/*.md"],"excludeFiles":[]},{"title":"Plugins","includeFiles":["additional-resources/plugins/**/*.md"],"excludeFiles":[]},{"title":"Industry Considerations","includeFiles":["guides/industry-considerations/**/*.md"],"excludeFiles":[]},{"title":"Regional Considerations","includeFiles":["guides/regional-considerations/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]},"image":"/assets/guides-online-payments-payment-features-buyer-charges-card-brand-fees-visa-rent-fees.e11e0fee7fdd937191a3dc1df52979b22467807836b8c23401ba52cd67d95b44.04fe652d.png"},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rent-surcharge","__idx":0},"children":["Rent Surcharge"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn about the requirements and what you can do with the Rent Surcharge."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Rent Surcharge is available to sellers to charge renters a fee for making payments to qualified landlords under the Visa Rent Payment Program."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Through the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://usa.visa.com/dam/VCOM/download/about-visa/visa-rules-public.pdf"},"children":["Visa Rent Payment Program"]}," (section 5.8.21 - Visa Rent Payment Program), Visa allows landlords to collect a fee from renters who use their credit or debit cards to pay for rent in an online environment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Merchants"]}," must be registered for the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://usa.visa.com/dam/VCOM/download/about-visa/visa-rules-public.pdf"},"children":["Visa Rent Payment Program"]}," (section 5.8.21 - Visa Rent Payment Program) through Finix. To register, reach out to your Finix Point of Contact or Finix Support. Please allow up to 35 days for registration to be completed. Please note each individual ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Merchant"]}," account needs to be registered before charging a Rent Surcharge."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sellers and your integration must meet these requirements to charge a Rent Surcharge:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Rent Surcharge needs to be clearly displayed to the buyer before they approve a transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the transaction is with a debit card, the Rent Surcharge can't be greater than $10."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the transaction is with a credit card, the fee needs to follow the same requirements as ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/payment-features/buyer-charges/card-brand-fees/surcharge-fees"},"children":["Surcharge Fees"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The buyer must be aware of the fee and its purpose before making a payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After the fee gets disclosed, the buyer must have the option to cancel the transaction without any consequences."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Payment ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Instrument#card_type"]}," field details if a debit (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEBIT"]},") or credit card (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDIT"]},") was used."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"using-the-api","__idx":2},"children":["Using the API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the Rent Surcharge in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rent_surcharge_amount"]}," when creating a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Transfer"]}," or an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rent_surcharge_amount"]}," to mark which portion of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Transfer#amount"]}," is a Rent Surcharge. See the following for an example where:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The transaction is for a $10,000 in rent with a Rent Surcharge of $10."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The fee is included in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]}," for tracking purposes."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Example","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-api/index.yaml","operationId":"createTransfer","exampleKey":"Transfer - Rent Surcharge","parameters":{},"environments":{}},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"API Definition","disable":false},"children":[{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../../../../api/components/schemas/requestBodies/transfers/createTransferRentSurcharge.yaml"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/createTransferRentSurcharge"},"additional_buyer_charges":{"type":"object","description":"Additional charges will be incurred by the buyer.\n\nThe following rules apply:\n\n- The `Merchant` must be enabled to charge these surcharges by setting the appropriate flags for each applicable surcharge to `true` using the PUT `/merchants` endpoint.\n- Only _one_ of the following charges can be applied during creation.\n","nullable":true,"properties":{"convenience_amount":{"type":"integer","description":"A convenience fee to charge the buyer for the transaction. This object property is mutually exclusive.","nullable":true},"rent_surcharge_amount":{"type":"integer","description":"A rent surcharge to charge the buyer for the transaction. This object property is mutually exclusive.","nullable":true},"surcharge_amount":{"type":"integer","description":"A surcharge amount to charge the buyer for the transaction. This object property is mutually exclusive.","nullable":true}}},"amount":{"type":"integer","description":"The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).","example":5000,"format":"int64"},"currency":{"type":"string","description":"ISO 4217 3-letter currency code.","enum":["CAD","USD"]},"source":{"type":"string","example":"PIxxxxxxxxxxxxxxxxxx","description":"ID of the `Payment Instrument` where funds get debited."},"createTransferRentSurcharge":{"title":"Transfer - Rent Surcharge","properties":{"additional_buyer_charges":{"description":"Details about any [Buyer Charges](/guides/online-payments/payment-features/buyer-charges) included in the `Transfer`. The buyer charges are mutually exclusive.\n","allOf":[{"$ref":"#/components/schemas/additional_buyer_charges"}]},"amount":{"$ref":"#/components/schemas/amount"},"currency":{"$ref":"#/components/schemas/currency"},"merchant":{"type":"string","description":"The ID of the `Merchant` under which to create the `Transfer`."},"source":{"$ref":"#/components/schemas/source"}},"required":["amount","currency","merchant","source"]}}}},"schemaResolvedErrors":[]},"children":[]}]}]}]},"headings":[{"value":"Rent Surcharge","id":"rent-surcharge","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Using the API","id":"using-the-api","depth":2}],"frontmatter":{"seo":{"title":"Rent Surcharge","description":"The Rent Surcharge lets qualified landlords charge renters a fee for card payments under the Visa Rent Payment Program. Covers requirements and API usage.","image":"/assets/guides-online-payments-payment-features-buyer-charges-card-brand-fees-visa-rent-fees.e11e0fee7fdd937191a3dc1df52979b22467807836b8c23401ba52cd67d95b44.04fe652d.png"},"keywords":{"includes":["rent surcharge","rent payment","Visa rent payment program"],"excludes":["authorization","buyer charges","card brand fees","convenience fees","merchant","payment instrument","surcharge fees"]}},"lastModified":"2026-05-14T20:16:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/online-payments/payment-features/buyer-charges/card-brand-fees/rent-surcharge","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}