{"title":"Installments in Mexico","category":"default","creationDate":1776961627,"content":"<p>In Mexico, shoppers can use most credit cards to make payments in installments. Combo cards that have both a debit and a credit functionality can also be used to pay in installments.<\/p>\n<p>If a shopper chooses to pay in installments, you receive the full amount. However, you are responsible for the installment fees charged by the issuer.<\/p>\n<p>This page explains how to flag in-store card payments as credit or debit and make credit card installment payments in a Terminal API integration.<\/p>\n<h2>Requirements<\/h2>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">A <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/\">Terminal API<\/a> integration with payment terminals.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Supported in Mexico with specific issuing banks. See the list of <a href=\"#supported-cards\">supported cards<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"terminal-api\">How it works<\/h2>\n<ol>\n<li>\n<p>Your store staff asks the shopper how they prefer to pay:<\/p>\n<ul>\n<li>Do they want to pay by debit or credit?<\/li>\n<li>If credit, do they want to make a one-off payment of the total amount or do they want to pay in installments?<\/li>\n<li>If installments, how many installments?<\/li>\n<\/ul>\n<!-- list separator -->\n<\/li>\n<li>\n<p>Your store staff enters this information into your POS app.<\/p>\n<\/li>\n<li>\n<p>Your POS app passes this information in the <a href=\"#payment-terminal-api\">payment request<\/a>.<\/p>\n<\/li>\n<li>\n<p>The shopper presents their card to the terminal and completes the payment.<\/p>\n<\/li>\n<li>\n<p>When the transaction is approved, you receive a response containing installment and receipt data.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"payment-terminal-api\">Make a payment<\/h2>\n<p>The Terminal API payment request needs to contain a flag to indicate a debit or credit card payment. When paying by credit in installments, the request also needs to contain an object to define the installments.<\/p>\n<ol>\n<li>\n<p>Make sure that your POS app collects the following information and passes it to the Terminal API payment request:<\/p>\n<ul>\n<li>Whether the shopper is going to pay by debit or credit.<\/li>\n<li>If credit: whether the shopper wants to pay in installments.<\/li>\n<li>If credit installments: how many installments.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">Make a payment request<\/a>, specifying:<\/p>\n<ul>\n<li>\n<p>The standard <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#request-message-header\">\n  <code>SaleToPOIRequest.MessageHeader<\/code>\n<\/a> object, with <code>MessageClass<\/code> set to <span translate=\"no\"><strong>Service<\/strong><\/span> and <code>MessageCategory<\/code> set to <span translate=\"no\"><strong>Payment<\/strong><\/span>.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>ProtocolVersion<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><strong>3.0<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageClass<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Service<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageCategory<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Payment<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageType<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Request<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>ServiceID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (<code>POIID<\/code>) being used.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for the POS system component to send this request from.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>POIID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique ID of the terminal to send this request to. Format: <em>[device model]-[serial number]<\/em>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<ul>\n<li>\n<p>The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentRequest<\/a> object with:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleTransactionID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>TransactionID<\/code>: your reference to identify a payment. We recommend using a unique value per payment. In your Customer Area and Adyen reports, this will show as the <strong>merchant reference<\/strong> for the transaction.<\/li> <li markdown=\"1\"><code>TimeStamp<\/code>: date and time of the request in <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_8601#Coordinated_Universal_Time_(UTC)\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">UTC format<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>PaymentTransaction.AmountsReq<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>Currency<\/code>: the transaction <a href=\"\/pt\/development-resources\/currency-codes\">currency<\/a>.<\/li><li markdown=\"1\"><code>RequestedAmount<\/code>: The final transaction amount.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Add a flag to specify if the shopper wants to pay by debit or credit:<\/p>\n<ul>\n<li><code>TransactionConditions.DebitPreferredFlag<\/code>:\n<ul>\n<li><span translate=\"no\"><strong>true<\/strong><\/span>: makes a debit card payment.<\/li>\n<li><span translate=\"no\"><strong>false<\/strong><\/span>: makes a credit card payment.<\/li>\n<\/ul><\/li>\n<\/ul>\n<p>For a debit card payment or a one-off credit card payment, no further parameters are required.<\/p>\n<\/li>\n<li>\n<p>If the shopper is paying by credit card in installments, define the installments by adding:<\/p>\n<ul>\n<li><code>PaymentData<\/code>: the installment details. This contains:\n<ul>\n<li><code>PaymentType<\/code>: <span translate=\"no\"><strong>Instalment<\/strong><\/span><\/li>\n<li><code>Instalment.TotalNbOfPayments<\/code>: the number of installments. The minimum is <strong>3<\/strong>, the maximum <strong>18<\/strong>.<\/li>\n<\/ul><\/li>\n<\/ul>\n<p>Here are some sample requests:<\/p>\n\n<div id=\"tabXLZIs\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Debit card payment&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;&#039;\\&quot; :id=\\&quot;&#039;mexico-payments_0&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n  \\\\\\&quot;SaleToPOIRequest\\\\\\&quot;:{\\\\n    \\\\\\&quot;MessageHeader\\\\\\&quot;:{\\\\n      \\\\\\&quot;ProtocolVersion\\\\\\&quot;:\\\\\\&quot;3.0\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageClass\\\\\\&quot;:\\\\\\&quot;Service\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageCategory\\\\\\&quot;:\\\\\\&quot;Payment\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageType\\\\\\&quot;:\\\\\\&quot;Request\\\\\\&quot;,\\\\n      \\\\\\&quot;ServiceID\\\\\\&quot;:\\\\\\&quot;2307d64b8\\\\\\&quot;,\\\\n      \\\\\\&quot;SaleID\\\\\\&quot;:\\\\\\&quot;Demo\\\\\\&quot;,\\\\n      \\\\\\&quot;POIID\\\\\\&quot;:\\\\\\&quot;P400Plus-275040710\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;PaymentRequest\\\\\\&quot;:{\\\\n      \\\\\\&quot;SaleData\\\\\\&quot;:{\\\\n        \\\\\\&quot;SaleTransactionID\\\\\\&quot;:{\\\\n          \\\\\\&quot;TransactionID\\\\\\&quot;:\\\\\\&quot;TID-2018-07-23-21:43:03\\\\\\&quot;,\\\\n          \\\\\\&quot;TimeStamp\\\\\\&quot;:\\\\\\&quot;2018-07-23T21:43:03\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;SaleReferenceID\\\\\\&quot;:\\\\\\&quot;TID-2018-07-23-21:43:03\\\\\\&quot;,\\\\n        \\\\\\&quot;SaleToAcquirerData\\\\\\&quot;:\\\\\\&quot;\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;PaymentTransaction\\\\\\&quot;:{\\\\n        \\\\\\&quot;AmountsReq\\\\\\&quot;:{\\\\n          \\\\\\&quot;Currency\\\\\\&quot;:\\\\\\&quot;MXN\\\\\\&quot;,\\\\n          \\\\\\&quot;RequestedAmount\\\\\\&quot;:120.00\\\\n        },\\\\n        \\\\\\&quot;TransactionConditions\\\\\\&quot;:{\\\\n          \\\\\\&quot;DebitPreferredFlag\\\\\\&quot;:true\\\\n        }\\\\n      }\\\\n    }\\\\n  }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;debit_card_payment_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Credit card payment without installments&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;&#039;\\&quot; :id=\\&quot;&#039;mexico-payments_1&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n  \\\\\\&quot;SaleToPOIRequest\\\\\\&quot;:{\\\\n    \\\\\\&quot;MessageHeader\\\\\\&quot;:{\\\\n      \\\\\\&quot;ProtocolVersion\\\\\\&quot;:\\\\\\&quot;3.0\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageClass\\\\\\&quot;:\\\\\\&quot;Service\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageCategory\\\\\\&quot;:\\\\\\&quot;Payment\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageType\\\\\\&quot;:\\\\\\&quot;Request\\\\\\&quot;,\\\\n      \\\\\\&quot;ServiceID\\\\\\&quot;:\\\\\\&quot;2307d64b8\\\\\\&quot;,\\\\n      \\\\\\&quot;SaleID\\\\\\&quot;:\\\\\\&quot;Demo\\\\\\&quot;,\\\\n      \\\\\\&quot;POIID\\\\\\&quot;:\\\\\\&quot;P400Plus-275040710\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;PaymentRequest\\\\\\&quot;:{\\\\n      \\\\\\&quot;SaleData\\\\\\&quot;:{\\\\n        \\\\\\&quot;SaleTransactionID\\\\\\&quot;:{\\\\n          \\\\\\&quot;TransactionID\\\\\\&quot;:\\\\\\&quot;TID-2018-07-23-21:43:03\\\\\\&quot;,\\\\n          \\\\\\&quot;TimeStamp\\\\\\&quot;:\\\\\\&quot;2018-07-23T21:43:03\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;SaleReferenceID\\\\\\&quot;:\\\\\\&quot;TID-2018-07-23-21:43:03\\\\\\&quot;,\\\\n        \\\\\\&quot;SaleToAcquirerData\\\\\\&quot;:\\\\\\&quot;\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;PaymentTransaction\\\\\\&quot;:{\\\\n        \\\\\\&quot;AmountsReq\\\\\\&quot;:{\\\\n          \\\\\\&quot;Currency\\\\\\&quot;:\\\\\\&quot;MXN\\\\\\&quot;,\\\\n          \\\\\\&quot;RequestedAmount\\\\\\&quot;:120.00\\\\n        },\\\\n        \\\\\\&quot;TransactionConditions\\\\\\&quot;:{\\\\n          \\\\\\&quot;DebitPreferredFlag\\\\\\&quot;:false\\\\n        }\\\\n      }\\\\n    }\\\\n  }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;credit_card_payment_without_installments_1_2&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Credit card payment with 12 installments&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;&#039;\\&quot; :id=\\&quot;&#039;mexico-payments_2&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n  \\\\\\&quot;SaleToPOIRequest\\\\\\&quot;:{\\\\n    \\\\\\&quot;MessageHeader\\\\\\&quot;:{\\\\n      \\\\\\&quot;ProtocolVersion\\\\\\&quot;:\\\\\\&quot;3.0\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageClass\\\\\\&quot;:\\\\\\&quot;Service\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageCategory\\\\\\&quot;:\\\\\\&quot;Payment\\\\\\&quot;,\\\\n      \\\\\\&quot;MessageType\\\\\\&quot;:\\\\\\&quot;Request\\\\\\&quot;,\\\\n      \\\\\\&quot;SaleID\\\\\\&quot;:\\\\\\&quot;Demo\\\\\\&quot;,\\\\n      \\\\\\&quot;ServiceID\\\\\\&quot;:\\\\\\&quot;2307d64b8\\\\\\&quot;,\\\\n      \\\\\\&quot;POIID\\\\\\&quot;:\\\\\\&quot;P400Plus-275040710\\\\\\&quot;\\\\n    },\\\\n    \\\\\\&quot;PaymentRequest\\\\\\&quot;:{\\\\n      \\\\\\&quot;SaleData\\\\\\&quot;:{\\\\n        \\\\\\&quot;SaleTransactionID\\\\\\&quot;:{\\\\n          \\\\\\&quot;TransactionID\\\\\\&quot;:\\\\\\&quot;TID-2022-09-11-21:43:03\\\\\\&quot;,\\\\n          \\\\\\&quot;TimeStamp\\\\\\&quot;:\\\\\\&quot;2022-11-09T14:43:03\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;SaleReferenceID\\\\\\&quot;:\\\\\\&quot;TID-2022-11-09-21:43:03\\\\\\&quot;,\\\\n        \\\\\\&quot;SaleToAcquirerData\\\\\\&quot;:\\\\\\&quot;\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;PaymentTransaction\\\\\\&quot;:{\\\\n        \\\\\\&quot;AmountsReq\\\\\\&quot;:{\\\\n          \\\\\\&quot;Currency\\\\\\&quot;:\\\\\\&quot;MXN\\\\\\&quot;,\\\\n          \\\\\\&quot;RequestedAmount\\\\\\&quot;:120.00\\\\n        },\\\\n        \\\\\\&quot;TransactionConditions\\\\\\&quot;:{\\\\n          \\\\\\&quot;DebitPreferredFlag\\\\\\&quot;:false\\\\n        }\\\\n      },\\\\n      \\\\\\&quot;PaymentData\\\\\\&quot;:{\\\\n        \\\\\\&quot;PaymentType\\\\\\&quot;:\\\\\\&quot;Instalment\\\\\\&quot;,\\\\n        \\\\\\&quot;Instalment\\\\\\&quot;:{\\\\n          \\\\\\&quot;TotalNbOfPayments\\\\\\&quot;:12\\\\n        }\\\\n      }\\\\n    }\\\\n  }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;credit_card_payment_with_12_installments_2_3&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<\/li>\n<li>\n<p>Check the payment result.<br \/>\nIf the payment is successful, the terminal shows the payment is approved, and you receive a <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#responses\">Terminal API response<\/a>. This response contains:<\/p>\n<ul>\n<li>\n<p><code>PaymentReceipt<\/code>: dynamically generated receipt data that you can use for printing (or emailing) receipts. Both the merchant receipt and the shopper receipt have additional required keys:<\/p>\n<ul>\n<li><code>productType<\/code>: indicates if the shopper paid by debit, credit, or credit in a specified number of installments.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>If the shopper paid in installments, the response also includes:<\/p>\n<ul>\n<li><code>PaymentResult.PaymentType<\/code>: <span translate=\"no\"><strong>Instalment<\/strong><\/span><\/li>\n<li><code>PaymentResult.Instalment<\/code>: object containing the same installment details that you defined in the <code>PaymentData<\/code> of your <code>PaymentRequest<\/code>.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>Here is a sample response for a <strong>credit card payment with 12 installments<\/strong>:<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Payment response with 12 installments'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"SaleToPOIResponse\\\":{\\n        \\\"MessageHeader\\\":{...},\\n        \\\"PaymentResponse\\\":{\\n            \\\"PaymentReceipt\\\":[...],\\n            \\\"POIData\\\":{...},\\n            \\\"PaymentResult\\\":{\\n                \\\"PaymentType\\\":\\\"Instalment\\\",\\n                ...\\n                \\\"Instalment\\\":{\\n                    \\\"TotalNbOfPayments\\\":12\\n                },\\n                ...\\n            },\\n            \\\"SaleData\\\":{...},\\n            \\\"Response\\\":{\\\"Result\\\": \\\"Success\\\"...}\\n        }\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2 id=\"reconciling-installments\">Reconciling installments<\/h2>\n<p>If a shopper chooses to pay in installments, the full purchase amount is deducted from their credit card limit. The issuing bank then deducts the amount for each monthly installment from their debit account. Typically, shoppers choose to pay in 3 to 18 monthly installments.<\/p>\n<p>You as the merchant receive the full purchase amount from the issuing bank. However, you are responsible for the installment fees charged by the issuer.<\/p>\n<h2>Supported cards<\/h2>\n<p>Currently, Adyen supports five different installment programs in Mexico. These programs and the participating card issuers are:<\/p>\n<ul>\n<li>\n<p>Prosa installments program: AFIRME, AZTECA, BANBAJIO, BANCA MIFEL, BANJERCITO, BANORTE, BANREGIO, CAJA MORELIA, CREDICLUB, EFEVOO, FALABELLA, INBURSA, INVEX, KLAR, KONFIO, LIVERPOOL, RAPPI CARD, SANTANDER, SCOTIABANK, SUBURBIA.<\/p>\n<\/li>\n<li>\n<p>Mastercard installments program: FINSUS, PLATA REGIGOLD, REVOLUT, STORI, UALA.<\/p>\n<\/li>\n<li>\n<p>Nubank installments program: NU.<\/p>\n<\/li>\n<li>\n<p>Citibanamex installments program: BANAMEX.<\/p>\n<\/li>\n<li>\n<p>Bancoppel installments program: BANCOPPEL.<\/p>\n<\/li>\n<\/ul>\n<p>To accept installment payments made with cards issued by other banks, you must have a legal agreement directly with the bank that issued the card.<\/p>\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment\"\n                        target=\"_self\"\n                        >\n                    Make a Terminal API payment\n                <\/a><\/li><li><a href=\"\/point-of-sale\/basic-tapi-integration\/generate-receipts\"\n                        target=\"_self\"\n                        >\n                    Receipts\n                <\/a><\/li><li><a href=\"\/point-of-sale\/design-your-integration\/notifications\"\n                        target=\"_self\"\n                        >\n                    Receiving webhooks\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/installments\/mexico-installments","articleFields":{"description":"Flag the payment as debit or credit, and make credit card installment payments in Mexico.","page_id":"d469c784-dbda-4430-bb9e-dab9a9ba25e9","feedback_component":true,"filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/installments\/mexico-installments","title":"Installments in Mexico","content":"In Mexico, shoppers can use most credit cards to make payments in installments. Combo cards that have both a debit and a credit functionality can also be used to pay in installments.\nIf a shopper chooses to pay in installments, you receive the full amount. However, you are responsible for the installment fees charged by the issuer.\nThis page explains how to flag in-store card payments as credit or debit and make credit card installment payments in a Terminal API integration.\nRequirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA Terminal API integration with payment terminals.\n\n\nLimitations\nSupported in Mexico with specific issuing banks. See the list of supported cards.\n\n\n\nHow it works\n\n\nYour store staff asks the shopper how they prefer to pay:\n\nDo they want to pay by debit or credit?\nIf credit, do they want to make a one-off payment of the total amount or do they want to pay in installments?\nIf installments, how many installments?\n\n\n\n\nYour store staff enters this information into your POS app.\n\n\nYour POS app passes this information in the payment request.\n\n\nThe shopper presents their card to the terminal and completes the payment.\n\n\nWhen the transaction is approved, you receive a response containing installment and receipt data.\n\n\nMake a payment\nThe Terminal API payment request needs to contain a flag to indicate a debit or credit card payment. When paying by credit in installments, the request also needs to contain an object to define the installments.\n\n\nMake sure that your POS app collects the following information and passes it to the Terminal API payment request:\n\nWhether the shopper is going to pay by debit or credit.\nIf credit: whether the shopper wants to pay in installments.\nIf credit installments: how many installments.\n\n\n\nMake a payment request, specifying:\n\n\nThe standard \n  SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Service and MessageCategory set to Payment.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nService\n\n\nMessageCategory\n\nPayment\n\n\nMessageType\n\nRequest\n\n\nServiceID\n\nYour unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.\n\n\nSaleID\n\nYour unique ID for the POS system component to send this request from.\n\n\nPOIID\n\nThe unique ID of the terminal to send this request to. Format: [device model]-[serial number].\n\n\n\n\n\n\n\nThe  PaymentRequest object with:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nSaleData.SaleTransactionID\n\nAn object with: TransactionID: your reference to identify a payment. We recommend using a unique value per payment. In your Customer Area and Adyen reports, this will show as the merchant reference for the transaction. TimeStamp: date and time of the request in UTC format.\n\n\nPaymentTransaction.AmountsReq\n\nAn object with: Currency: the transaction currency.RequestedAmount: The final transaction amount.\n\n\n\n\n\n\n\nAdd a flag to specify if the shopper wants to pay by debit or credit:\n\nTransactionConditions.DebitPreferredFlag:\n\ntrue: makes a debit card payment.\nfalse: makes a credit card payment.\n\n\nFor a debit card payment or a one-off credit card payment, no further parameters are required.\n\n\nIf the shopper is paying by credit card in installments, define the installments by adding:\n\nPaymentData: the installment details. This contains:\n\nPaymentType: Instalment\nInstalment.TotalNbOfPayments: the number of installments. The minimum is 3, the maximum 18.\n\n\nHere are some sample requests:\n\n\n    \n        \n        \n    \n\n\n\n\nCheck the payment result.\nIf the payment is successful, the terminal shows the payment is approved, and you receive a Terminal API response. This response contains:\n\n\nPaymentReceipt: dynamically generated receipt data that you can use for printing (or emailing) receipts. Both the merchant receipt and the shopper receipt have additional required keys:\n\nproductType: indicates if the shopper paid by debit, credit, or credit in a specified number of installments.\n\n\n\nIf the shopper paid in installments, the response also includes:\n\nPaymentResult.PaymentType: Instalment\nPaymentResult.Instalment: object containing the same installment details that you defined in the PaymentData of your PaymentRequest.\n\n\n\nHere is a sample response for a credit card payment with 12 installments:\n\n\n\n\n\nReconciling installments\nIf a shopper chooses to pay in installments, the full purchase amount is deducted from their credit card limit. The issuing bank then deducts the amount for each monthly installment from their debit account. Typically, shoppers choose to pay in 3 to 18 monthly installments.\nYou as the merchant receive the full purchase amount from the issuing bank. However, you are responsible for the installment fees charged by the issuer.\nSupported cards\nCurrently, Adyen supports five different installment programs in Mexico. These programs and the participating card issuers are:\n\n\nProsa installments program: AFIRME, AZTECA, BANBAJIO, BANCA MIFEL, BANJERCITO, BANORTE, BANREGIO, CAJA MORELIA, CREDICLUB, EFEVOO, FALABELLA, INBURSA, INVEX, KLAR, KONFIO, LIVERPOOL, RAPPI CARD, SANTANDER, SCOTIABANK, SUBURBIA.\n\n\nMastercard installments program: FINSUS, PLATA REGIGOLD, REVOLUT, STORI, UALA.\n\n\nNubank installments program: NU.\n\n\nCitibanamex installments program: BANAMEX.\n\n\nBancoppel installments program: BANCOPPEL.\n\n\nTo accept installment payments made with cards issued by other banks, you must have a legal agreement directly with the bank that issued the card.\nSee also\n\n\n                    Make a Terminal API payment\n                \n                    Receipts\n                \n                    Receiving webhooks\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Installments","lvl3":"Installments in Mexico"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/installments","lvl3":"\/pt\/point-of-sale\/installments\/mexico-installments"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Installments","Mexico"]},"articleFiles":{"mexico-payments_0.json":"<p alt=\"\">mexico-payments_0.json<\/p>","mexico-payments_1.json":"<p alt=\"\">mexico-payments_1.json<\/p>","mexico-payments_2.json":"<p alt=\"\">mexico-payments_2.json<\/p>"}}
