# Create payment

This endpoint allows you to create a payment and include all the necessary information. Make sure to add the payment details and the customer's information. In case of success, the request will return a response with status 201.

**POST** `/v1/payments`

## Request parameters

### Header

- `X-Idempotency-Key` (string, required)
  This feature allows you to safely retry requests without the risk of accidentally performing the same action more than once. This is useful for avoiding errors, such as creating two identical payments, for example. To ensure that each request is unique, it's important to use an exclusive value in the header of your request. We suggest using a UUID V4 or random strings.

- `additional_info` (object, optional)
  At Payments level, it's only data, and we only forward that information to other APIs like Risk, to perform scoring and prevent fraud, or to Tax, to determine them for international payments.

  - `additional_info.ip_address` (string, optional)
  Internal protocol (IP) that comes from the request (for bank transfer only).

  - `additional_info.items` (array, optional)
  List of items to be paid.

  - `additional_info.items[].id` (string, optional)
  It is the purchased product ad identifier. For example - “MLB2907679857”.

  - `additional_info.items[].title` (string, optional)
  Product title. To learn how to create a good title, check out the article: https://bit.ly/4dJmU89

  - `additional_info.items[].description` (string, optional)
  Product description.

  - `additional_info.items[].picture_url` (string, optional)
  Image URL.

  - `additional_info.items[].category_id` (string, optional)
  It is the category of the purchased item. It is possible to mention two main forms of category_id - categories inserted through a code, such as “MLB189908”, or those that are a tag, such as “phone”.

  - `additional_info.items[].quantity` (number, optional)
  Item quantity. This parameter will return as an String.

  - `additional_info.items[].unit_price` (number, optional)
  Unit price of the purchased item. The field can contain two decimal places or none.

  - `additional_info.items[].type` (string, optional)
  Type of item being sold

  - `additional_info.items[].event_date` (string, optional)
  Event Date - Use the standard ISO 8601 format to input the date and time of the event. The format should be "yyyy-MM-ddTHH:mm:ss.sssZ". For example, to schedule an event for December 31, 2023, at 9:37:52 AM in the UTC-4 timezone, you would enter "2023-12-31T09:37:52.000-04:00".

  - `additional_info.items[].warranty` (boolean, optional)
  Indicates if the product has warranty or not. True if it does, false if it doesn't.

  - `additional_info.items[].category_descriptor` (object, optional)

  - `additional_info.items[].category_descriptor.passenger` (object, optional)

  - `additional_info.items[].category_descriptor.passenger.first_name` (string, optional)
  Passenger's first name.

  - `additional_info.items[].category_descriptor.passenger.last_name` (string, optional)
  Passenger's last name.

  - `additional_info.items[].category_descriptor.route` (object, optional)

  - `additional_info.items[].category_descriptor.route.departure` (string, optional)
  Departure city.

  - `additional_info.items[].category_descriptor.route.destination` (string, optional)
  Destination city.

  - `additional_info.items[].category_descriptor.route.departure_date_time` (string, optional)
  Departure date and time. Valid format is as follows - "yyyy-MM-ddTHH:mm:ss.sssZ". Example - 2023-12-31T09:37:52.000-04:00.

  - `additional_info.items[].category_descriptor.route.arrival_date_time` (string, optional)
  Arrival date and time. Valid format is as follows - "yyyy-MM-ddTHH:mm:ss.sssZ". Example - 2023-12-31T09:37:52.000-04:00.

  - `additional_info.items[].category_descriptor.route.company` (string, optional)
  Company name.

  - `additional_info.payer` (object, optional)
  The payer is the one who makes the payment. This field is an object that has the payer's information.

  - `additional_info.payer.first_name` (string, optional)
  Buyer's name.

  - `additional_info.payer.last_name` (string, optional)
  It's the buyer's last name field.

  - `additional_info.payer.phone` (object, optional)
  Buyer's phone.

  - `additional_info.payer.phone.area_code` (string, optional)
  Area code where the buyer resides.

  - `additional_info.payer.phone.number` (string, optional)
  Buyer's fone number.

  - `additional_info.payer.address` (object, optional)
  Buyer's address.

  - `additional_info.payer.address.zip_code` (string, optional)
  Buyer's zip code.

  - `additional_info.payer.address.street_name` (string, optional)
  Street where the buyer lives.

  - `additional_info.payer.address.street_number` (number, optional)
  Number of the property where the buyer lives. If you do not have a number, send "N/A".

  - `additional_info.payer.address.neighborhood` (number, optional)
  Name of the neighborhood where the buyer resides. This field is required for payments made by boleto.

  - `additional_info.payer.address.city` (number, optional)
  City where the buyer resides. This field is mandatory for payments with boleto.

  - `additional_info.payer.address.federal_unit` (number, optional)
  Federal unit of the buyer. This field is mandatory for payments made via boleto.

  - `additional_info.payer.registration_date` (string, optional)
  Date of registration of the buyer (payer) on your website. The valid format of the attribute is as follows - "yyyy-MM-dd'T'HH:mm:ssz". Ex - 2021-06-15T19:22:41.001-03:00.

  - `additional_info.payer.is_prime_user` (string, optional)
  Indicates if the payer is a premium user. Valid values are as follows - "true" if it is, "false" if it isn't.

  - `additional_info.payer.is_first_purchase_online` (string, optional)
  Indicates if the payer has made a purchase on your website before. Valid values are as follows - "1" if it is, "0" if it isn't.

  - `additional_info.payer.last_purchase` (string, optional)
  Date of the last purchase made by the payer on your website. The valid format of the attribute is as follows - "yyyy-MM-dd'T'HH:mm:ssz". Ex - 2021-06-15T19:22:41.001-03:00.

  - `additional_info.payer.authentication_type` (string, optional)
  Type of authentication used by payer.
Possible enum values:

  - `Gmail`
  Authentication via Gmail.

  - `Facebook`
  Authentication via Facebook login.

  - `Native web`
  Authentication via web application

  - `Other`
  Other type of identification

  - `additional_info.shipments` (object, optional)
  Object containing all the information for shipping the customer's purchase.

  - `additional_info.shipments.receiver_address` (object, optional)
  Object comprising the address of the receiver of the purchase.

  - `additional_info.shipments.receiver_address.zip_code` (string, optional)
  Buyer's zip code.

  - `additional_info.shipments.receiver_address.state_name` (string, optional)
  Name of the State where the buyer's address is located.

  - `additional_info.shipments.receiver_address.city_name` (string, optional)
  Name of the city where the buyer's address is located.

  - `additional_info.shipments.receiver_address.street_name` (string, optional)
  Street where the buyer lives.

  - `additional_info.shipments.receiver_address.street_number` (number, optional)
  Number of the property where the buyer lives. If you do not have a number, send "N/A"

  - `additional_info.shipments.receiver_address.floor` (string, optional)
  Delivery address floor.

  - `additional_info.shipments.receiver_address.apartment` (string, optional)
  Delivery address apartment number.

  - `additional_info.shipments.width` (number, optional)
  Width of barcode.

  - `additional_info.shipments.height` (number, optional)
  Height of barcode.

  - `additional_info.shipments.express_shipment` (string, optional)
  Indicates if the shipment is express or not. Valid values are as follows - "1" if it is, "0" if it isn't.

  - `additional_info.shipments.pick_up_on_seller` (string, optional)
  Indicates if the customer will pick up the product at the seller's address. Valid values are as follows - "1" if it is, "0" if it isn't.

- `application_fee` (number, optional)
  Commission (fee) that third parties (integrators) charge their customers, in this case, sellers, for using the marketplace platform and other services. This is a value in reais to be defined by the integrator to the seller.

- `binary_mode` (boolean, optional)
  When set to TRUE, payments can only be approved or rejected. Otherwise they can also result in_process.

- `callback_url` (string, optional)
  URL where mercadopago does the final redirect (only for bank transfers).

- `campaign_id` (number, optional)
  It is the identifier of the entity that models the nature of discounts. All coupons come from a single campaign. The campaign configures, among other things, the available budget balance, dates between which coupons can be used, rules for coupon application. It's the discount promise.

- `capture` (boolean, optional)
  It is a boolean field found in two-step payments (like debit card). In this type of payment, which is carried out asynchronously, the purchase value is first reserved (capture = false). This amount is captured and not debited from the account instantly. When the money is actually transferred to the collector (who receives the payment) the amount is captured (capture = true).

- `coupon_amount` (number, optional)
  It is the value of the discount coupon. The field can contain two decimal places or none.

- `coupon_code` (string, optional)
  Discount campaign with a specific code.

- `description` (string, optional)
  Purchased product’s description, the reason for payment. E.g. - "Xiaomi Redmi Note 11S mobile phone 128gb 6gb Ram Original Global Blue Version" (description of a product in the marketplace).

- `differential_pricing_id` (number, optional)
  Attribute that commonly contains an agreement on how much the user will be charged (generally, this field is more relevant for Marketplace payments). Pricing and fees are calculated based on this identifier.

- `date_of_expiration` (string, optional)
  Payment’s expiration date. The valid format of the attribute is as follows - "yyyy-MM-dd HH:mm:ss.SSSz". Ex - 2022-11-17T09:37:52.000-04:00.

- `external_reference` (string, optional)
  It is a payment external reference. It could be, for example, a hashcode from the Central Bank, working as a transaction origin identifier. Important: This field must be a maximum of 64 characters and may only contain numbers, letters, hyphens (-), and underscores (_). Special characters such as ([ ], (), '', @) are not allowed.

- `installments` (number, optional)
  Number of installments selected.

- `issuer_id` (string, optional)
  It is the identifier of the card issuer being used in a credit or debit card payment.

- `metadata` (object, optional)
  This is an optional key-value object where the customer can add additional information that needs to be recorded at checkout. Ex - {"payments_group_size":1,"payments_group_timestamp":"2022-11-18T15:01:44Z","payments_group_uuid":"96cfd2a4-0b06-4dea-b25f-c5accb02ba10"}

- `notification_url` (string, optional)
  Notifications URL available to receive notifications of events related to Payment. The maximum number of characters allowed for submission in this parameter is 248 characters.

- `payer` (object, optional)
  Identifies the buyer.

  - `payer.entity_type` (string, optional)
  Entity type of the payer (only for bank transfers).
Possible enum values:

  - `individual`
  Payer is individual.

  - `association`
  Payer is an association.

  - `payer.type` (string, optional)
  Identification type of the associated payer (mandatory if the payer is a customer).
Possible enum values:

  - `customer`
  The payer is a registered customer and is associated with the collector.

  - `guest`
  The payer does not have an account.

  - `payer.id` (number, optional)
  Identification of the associated payer.

  - `payer.email` (string, optional)
  Email associated with the payer. This value will only return a response when status=approved, status=refunded, or status=charged_back.

  - `payer.identification` (object, optional)
  Payer's personal identification.

  - `payer.identification.type` (string, optional)
  Payer's identification document type. Access the endpoint '/v1/identification_type' to check all available identification types by country and get a list with the details of each one and their properties.

  - `payer.identification.number` (string, optional)
  Payer's identification document number.

  - `payer.first_name` (string, optional)
  First name of the associated payer.

  - `payer.last_name` (string, optional)
  Last name of the associated payer.

- `payment_method_id` (string, optional)
  Identifier of the payment method selected to make the payment. If it's a card payment, it will show the brand.
Possible enum values:

  - `Debin_transfer`
  Digital payment method that immediately debits an amount from an account, requesting prior authorization.

  - `CVU`
  The 'U'niform Virtual Key is a 22-digit code used to identify virtual accounts and make immediate transfers.

- `statement_descriptor` (string, optional)
  Description that the payment will appear with in the card statement (eg MERCADOPAGO)

- `token` (string, optional)
  Token card identifier (mandatory for credit card). The card token is created from the card's own information, increasing security during the payment flow. In addition, once the token is used in a given purchase, it is discarded, requiring the creation of a new token for future purchases.

- `transaction_amount` (number, optional)
  Product’s cost. The field can contain two decimal places or none.

## Response parameters

- `id` (number, optional)
  Unique Payment Identifier, automatically generated by Mercado Pago.

- `date_created` (string, optional)
  Payment creation date.

- `date_approved` (string, optional)
  Payment approval date. A payment can be generated in an intermediate state and then approved, so the creation date will not always coincide with the Approval Date.

- `date_last_updated` (string, optional)
  Date on which the last payment event was recorded.

- `date_of_expiration` (string, optional)
  Payment’s expiration date. The attribute’s valid format is as follows - "yyyy-MM-dd'T'HH:mm:ssz". Ex. - 2022-11-17T09:37:52.000-04:00.

- `money_release_date` (string, optional)
  Date on which the payment is settled and the money is made available in the Mercado Pago account of the Collector (the one who receives the payment). The field can take on the values “pending” or “released”, where the first indicates that the payment has not yet been released (money held for a period) and “released” means that the money has already been released to the user's available balance.

- `operation_type` (string, optional)
  Indicates the type of payment. The available types are as follows.
Possible enum values:

  - `investment`
  When funds are invested in products like CDB within the Mercado Pago app;

  - `regular_payment`
  Default classification for a purchase paid through Mercado Pago.

  - `money_transfer`
  Transfer of funds between two users.

  - `recurring_payment`
  Automatic payment for recurring charges from an active subscription.

  - `account_fund`
  Deposit of money into the user's account.

  - `payment_addition`
  Adding funds to an existing payment via a Mercado Pago account.

  - `cellphone_recharge`
  Reloading a user's cellphone account.

  - `pos_payment`
  Payment processed through a Point of Sale terminal.

  - `money_exchange`
  Currency exchange transaction for a user.

- `issuer_id` (string, optional)
  It is the identifier of the card issuer that’s being used in a credit or debit card payment.

- `payment_method_id` (string, optional)
  Identifier of the payment method selected to make the payment. If it's a card payment, it will show the brand.

- `payment_type_id` (string, optional)
  Type of payment method selected to make the payment.
Possible enum values:

  - `ticket`
  Cash payment.

  - `credit_card`
  Payment by credit card.

  - `debit_card`
  Payment by debit card.

  - `prepaid_card`
  Payment by prepaid card.

  - `digital_currency`
  Purchases with Cuotas sin Tarjeta.

  - `digital_wallet`
  Paypal.

  - `crypto_transfer`
  Payment with cryptocurrencies such as Ethereum and Bitcoin.

- `status` (string, optional)
  It is the payment’s current state. It can be of the following types.
Possible enum values:

  - `pending`
  The user has not yet completed the payment process (e.g., after generating a boleto, the payment will be completed when the user pays at the selected location).

  - `approved`
  The payment has been successfully approved and credited.

  - `authorized`
  The payment has been authorized but is not yet captured.

  - `in_process`
  The payment is currently under review.

  - `in_mediation`
  The user has initiated a dispute.

  - `rejected`
  The payment was rejected (the user may attempt to pay again).

  - `cancelled`
  The payment was either canceled by a party or expired.

  - `refunded`
  The payment was refunded to the user.

  - `charged_back`
  A chargeback was issued on the buyer's credit card.

- `status_detail` (string, optional)
  Detail in which the Collection resulted.
Possible enum values:

  - `accredited`
  Credited payment.

  - `partially_refunded`
  The payment has at least one partial refund.

  - `pending_capture`
  The payment has been authorized and is waiting for capture.

  - `offline_process`
  Due to lack of online processing, the payment is being processed offline.

  - `pending_contingency`
  Temporary failure. The payment will be processed deferred.

  - `pending_review_manual`
  The payment is under review to determine its approval or rejection.

  - `deferred_retry`
  The payment was scheduled to retry later.

  - `pending_waiting_transfer`
  In cases of bank transfer, the status_detail is obtained by waiting for the user to finish the payment process in their bank.

  - `pending_waiting_payment`
  In cases of offline payments, it remains pending until the user finishes the payment.

  - `pending_challenge`
  In cases of credit card payments, there is a pending confirmation due to a challenge.

  - `bank_error`
  If the payment method is bank transfer, the payment was rejected due to an error with the bank.

  - `cc_rejected_3ds_mandatory`
  The payment is rejected for not having a 3DS challenge when it is mandatory.

  - `cc_rejected_bad_filled_card_number`
  Incorrect card number.

  - `cc_rejected_bad_filled_date`
  Incorrect expiration date.

  - `cc_rejected_bad_filled_other`
  Incorrect card details.

  - `cc_rejected_bad_filled_security_code`
  Incorrect security code (CVV).

  - `cc_rejected_blacklist`
  The card is in the denial list, being present in problems related to theft/complaints/fraud.

  - `cc_rejected_call_for_authorize`
  The payment method requires prior authorization of the transaction value, which must be resolved between the payer and the entity.

  - `cc_rejected_card_disabled`
  The card is inactive.

  - `cc_rejected_duplicated_payment`
  Payment rejected due to duplicated transaction on the card issuer end.

  - `cc_rejected_high_risk`
  Rejected by Fraud Prevention.

  - `cc_rejected_insufficient_amount`
  The card limit is insufficient for this transaction.

  - `cc_rejected_invalid_installments`
  Invalid number of installments.

  - `cc_rejected_max_attempts`
  Maximum number of attempts exceeded.

  - `cc_rejected_other_reason`
  Generic error.

  - `cc_rejected_time_out`
  The transaction was rejected due to timeout.

  - `cc_amount_rate_limit_exceeded`
  Rejected because it exceeded the limit (CAP - Maximum Allowed Capacity) of the payment method.

  - `rejected_high_risk`
  Rejected due to risk assessment, credit scoring, or suspected fraud.

  - `rejected_insufficient_data`
  Rejected due to the lack of all required mandatory information in the payment.

  - `rejected_by_bank`
  Operation rejected by the bank.

  - `rejected_by_regulations`
  Payment rejected by regulations.

  - `rejected_by_biz_rule`
  Payment rejected by business rules.

- `currency_id` (string, optional)
  Identifier of the currency used in the payment.

- `description` (string, optional)
  Description sent in the payment creation request. Ex. - In a pix payment, the description is “Payment of Installments without card”. In another cases, such as a purchase in a physical store where the customer uses the machine to pay, we can find the description “Sale in person”. In marketplace purchases, the purchase description usually corresponds to a purchased product - “Pendrive Multilaser Twist Pd590 64gb 2.0 Black And Silver + 1 product”.

- `live_mode` (boolean, optional)
  Indicates whether the Payment was made in a production environment or in a Test environment. If TRUE, then the chargeback will be processed in production mode. If FALSE, then the chargeback will be processed in sandbox mode.

- `sponsor_id` (string, optional)
  This field is deprecated and no longer in use.

- `authorization_code` (string, optional)
  Transaction’s authorization code for payments with “payment_method_type” of type “credit_card” (credit card), “debit_card” (debit card) and “voucher_card” (voucher card for benefits, such as Alelo). In summary, this code is used for card transactions. The code is numerical and has 6 digits.

- `money_release_schema` (string, optional)
  This field is used to identify whether a payment is PNF (Payment in Flow). Payment in flow is a form of cash release in which the installments received by a seller are released over the months (which corresponds to the number of installments). Possible values ​​for this field are “null” or “payment_in_flow”.

- `taxes_amount` (number, optional)
  Corresponds to the tax values ​​calculated for the payment.

- `counter_currency` (string, optional)
  Basically, it is an object that will allow you to convert payments of CBT type (Cross Border Trade) into dollars, which are international payments made in a foreign currency.

- `shipping_amount` (number, optional)
  Amount of charge for shipping the purchase. It is of type BigDecimal.

- `pos_id` (string, optional)
  Point of Sale (POS) digital identifier. They are physical points of sale that use a card machine for sales.

- `store_id` (string, optional)
  Store identifier to which the point of sale belongs.

- `collector_id` (number, optional)
  It is the user who receives the money. Ex - A user (payer) buys a cell phone through the marketplace. The identifier of the store/seller to receive the payment is the collector_id.

- `payer` (object, optional)
  Payer information.

  - `payer.id` (number, optional)
  Payer identifier generated by Mercado Pago.

  - `payer.email` (string, optional)
  Email associated with the payer.

  - `payer.identification` (object, optional)
  Payer's personal identification.

  - `payer.identification.number` (string, optional)
  Payer's identification document number.

  - `payer.identification.type` (string, optional)
  Payer's identification document type. Access the endpoint '/v1/identification_type' to check all available identification types by country and get a list with the details of each one and their properties.

  - `payer.type` (string, optional)
  Identification type of the associated payer (mandatory if the payer is a customer).
Possible enum values:

  - `customer`
  The payer is a registered customer and is associated with the collector.

  - `guest`
  The payer does not have an account.

- `metadata` (object, optional)
  This is an optional key-value object where the customer can add additional information that needs to be recorded at checkout. Ex - {"payments_group_size":1,"payments_group_timestamp":"2022-11-18T15:01:44Z","payments_group_uuid":"96cfd2a4-0b06-4dea-b25f-c5accb02ba10"}.

- `additional_info` (object, optional)
  Additional information.

  - `additional_info.items` (array, optional)
  List of items to be paid.

  - `additional_info.items[].id` (string, optional)
  It is the purchased product ad identifier. Ex - “MLB2907679857”

  - `additional_info.items[].title` (string, optional)
  Item name.

  - `additional_info.items[].description` (string, optional)
  Long item description.

  - `additional_info.items[].picture_url` (string, optional)
  Image URL.

  - `additional_info.items[].category_id` (string, optional)
  Category of the item.

  - `additional_info.items[].quantity` (number, optional)
  Item quantity.

  - `additional_info.items[].unit_price` (number, optional)
  Unit price of the purchased item.

  - `additional_info.payer` (object, optional)
  Payer details.

  - `additional_info.payer.registration_date` (string, optional)
  Date of registration of the buyer on your site.

  - `additional_info.shipments` (object, optional)
  Shipping information.

  - `additional_info.shipments.receiver_address` (object, optional)
  Buyer's address.

  - `additional_info.shipments.receiver_address.street_name` (string, optional)
  Street where the buyer lives.

  - `additional_info.shipments.receiver_address.street_number` (number, optional)
  Number of the property where the buyer lives. If you do not have a number, send "N/A"

  - `additional_info.shipments.receiver_address.zip_code` (string, optional)
  Buyer's zip code.

  - `additional_info.shipments.receiver_address.city_name` (string, optional)
  Name of the city where the buyer's address is located.

  - `additional_info.shipments.receiver_address.state_name` (string, optional)
  Name of the State where the buyer's address is located.

- `external_reference` (string, optional)
  It is a payment external reference. It could be, for example, a hashcode from the Central Bank, working as a transaction origin identifier.

- `transaction_amount` (number, optional)
  Product’s cost.

- `transaction_amount_refunded` (number, optional)
  Transaction amount refunded.

- `coupon_amount` (number, optional)
  It is the value of the discount coupon.

- `differential_pricing_id` (string, optional)
  Attribute that commonly contains an agreement on how much the user will be charged (generally, this field is more relevant for Marketplace payments). Pricing and fees are calculated based on this identifier.

- `deduction_schema` (string, optional)
  Pricing Scheme applied by Mercado Pago. It is a field that represents the information of a type of financing (installment). Ex - “ahora12” is a schema that indicates that the payment is divided into 12 installments. In addition, financing may have an additional cost, such cost being included in that same answer and pointed out to whom this applies (payer/collector).

- `transaction_details` (object, optional)
  Transaction details.

  - `transaction_details.payment_method_reference_id` (string, optional)
  Unique identifier of the payment method.

  - `transaction_details.net_received_amount` (number, optional)
  Net amount received.

  - `transaction_details.total_paid_amount` (number, optional)
  Total amount charged to the payer.

  - `transaction_details.overpaid_amount` (number, optional)
  Overpaid amount.

  - `transaction_details.external_resource_url` (string, optional)
  External resource URL.

  - `transaction_details.installment_amount` (number, optional)
  Amount of the chosen financing fee.

  - `transaction_details.financial_institution` (string, optional)
  Financial institution.

  - `transaction_details.payable_deferral_period` (string, optional)
  Payment deferral period.

  - `transaction_details.acquirer_reference` (string, optional)
  Acquirer reference.

- `fee_details` (array, optional)
  Fee detail.

  - `fee_details[].type` (string, optional)
  Fee detail.
Possible enum values:

  - `mercadopago_fee`
  Fee for using Mercado Pago.

  - `coupon_fee`
  Discount applied using a coupon.

  - `financing_fee`
  Cost of financing.

  - `shipping_fee`
  Cost of shipping.

  - `application_fee`
  Marketplace commission for the service.

  - `discount_fee`
  Discount offered by the seller through cost absorption.

  - `fee_details[].amount` (number, optional)
  Fee amount.

  - `fee_details[].fee_payer` (string, optional)
  Who absorbs the cost.
Possible enum values:

  - `collector`
  The seller covers the cost.

  - `payer`
  The buyer covers the cost.

- `captured` (boolean, optional)
  Indicates if the payment amount was captured or is pending capture.

- `binary_mode` (boolean, optional)
  When set to TRUE, payments can only be approved or rejected. Otherwise they can also result in_process.

- `call_for_authorize_id` (string, optional)
  Identifier that is provided to the issuing bank so that payments can be authorized.

- `statement_descriptor` (string, optional)
  Description that the payment will appear with in the card statement (eg MERCADOPAGO).

- `installments` (number, optional)
  Number of installments selected.

- `card` (object, optional)
  Card details. For security reasons, sensitive card data is not exposed in the response.

  - `card.id` (string, optional)
  Card ID.

  - `card.first_six_digits` (string, optional)
  Card Bin.

  - `card.last_four_digits` (string, optional)
  Last 4 digits of the card.

  - `card.expiration_month` (number, optional)
  Card's expiration month.

  - `card.expiration_year` (number, optional)
  Card's expiration year.

  - `card.date_created` (string, optional)
  Card registration date.

  - `card.date_last_updated` (string, optional)
  Date on which the last payment event was recorded.

  - `card.cardholder` (object, optional)
  Cardholder details.

  - `card.cardholder.name` (string, optional)
  Name.

  - `card.cardholder.identification` (object, optional)
  Payer's personal identification.

  - `card.cardholder.identification.number` (string, optional)
  Payer's identification document number.

  - `card.cardholder.identification.type` (string, optional)
  Payer's identification document type. Access the endpoint '/v1/identification_type' to check all available identification types by country and get a list with the details of each one and their properties.

- `notification_url` (string, optional)
  Notifications URL available to receive notifications of events related to Payment. The maximum number of characters allowed for submission in this parameter is 248 characters.

- `processing_mode` (string, optional)
  Processing mode. There are two types.
Possible enum values:

  - `Aggregator`
  The merchant will use the Mercado Pago merchant codes and will take advantage of the financial advantages that we offer.

  - `Gateway`
  For the merchant it is necessary to have their own merchant codes for online sales and to have an agreement with each of the desired means of payment.

- `merchant_account_id` (string, optional)
  Merchant store code identifier. Applies only to the gateway model (since the delivery of money to the merchant does not go through the Mercado Pago system).

- `acquirer` (string, optional)
  Acquirer.

- `merchant_number` (string, optional)
  Merchant number (Applies to gateway model).

- `point_of_interaction` (object, optional)
  Information from the application that processes the payment and receives regulatory data.

  - `point_of_interaction.type` (string, optional)
  Payment type identifier.

  - `point_of_interaction.sub_type` (string, optional)
  Secondary identifier of the payment type.

  - `point_of_interaction.application_data` (object, optional)
  Information about the application that processes the payment.

  - `point_of_interaction.application_data.name` (string, optional)
  Application name.

  - `point_of_interaction.application_data.version` (string, optional)
  Current version.

  - `point_of_interaction.transaction_data` (object, optional)
  Information on the pending payment that was generated.

  - `point_of_interaction.transaction_data.qr_code_base64` (string, optional)
  Base64 representation of the image of the QR code to be scanned to finalize the payment.

  - `point_of_interaction.transaction_data.ticket_url` (string, optional)
  Link to the rendered Pix, with QR codes and instructions to pay.

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 400 | 1 | Params Error. - If this error appears, please verify the parameters sent in the request. |
| 400 | 3 | Token must be for test. - If this error occurs, ensure you are using a test token. |
| 400 | 8 | The name of the following parameters is wrong [additional_info.payer.test] - This error is displayed when the name of a certain parameter is entered incorrectly. In this example, the `additional_info.payer` field. Review the parameter returned in the error and ensure that the information entered is correct. |
| 400 | 23 | The following parameters must be valid date and format (yyyy-MM-dd'T'HH:mm:ssz) date_of_expiration. - If this error arises, ensure the date_of_expiration is in the correct format. |
| 400 | 1000 | Number of rows exceeded the limits. - If you encounter this error, reduce the number of rows in your request. |
| 400 | 2002 | Customer not found. - Verify the customer details and try again if you encounter this error. |
| 400 | 2004 | POST to Gateway Transactions API fail. - If this error occurs, check the API endpoint and try again. |
| 400 | 2006 | Card Token not found. - If you see this error, ensure the card token is correct and valid. |
| 400 | 2007 | Connection to Card Token API fail. - Check your network connection and try again if this error appears. |
| 400 | 2009 | Card token issuer can't be null. - Ensure that the card token issuer is provided if this error occurs. |
| 400 | 2034 | Invalid users involved. - If this error appears, ensure that all involved users are either productive or test users. Additionally, verify that the sponsor_id (if applicable) is correct and try again. |
| 400 | 2059 | You cannot use `application_fee` with this payment. - This error occurs because the Access Token being used was not obtained via OAuth. Make sure to use an Access Token generated through OAuth. |
| 400 | 2062 | Invalid card token. - Ensure that the card token provided is valid and correct if this error occurs. |
| 400 | 2067 | Invalid user identification number. - Verify the user identification number and try again if you encounter this error. |
| 400 | 2072 | Invalid value for transaction_amount. - Ensure that the transaction_amount is valid if this error appears. |
| 400 | 2077 | Deferred capture not supported. - If this error occurs, note that deferred capture is not supported and adjust your request accordingly. |
| 400 | 2123 | Invalid operators users involved. - If you see this error, verify the operators involved in the transaction. |
| 400 | 2131 | Cannot infer Payment Method. - Verify that the `payment_method` field is correctly filled out and matches the payment method used, as well as the number of installments (`installments`). |
| 400 | 2198 | Invalid test user email. - This error occurs when the payer.email attribute is sent using a non-test email while you are in a testing environment (e.g., using an email @testuser.com). If you encounter this error, check that you are indeed in a testing environment and, if so, use an email as specified. |
| 400 | 3000 | You must provide your cardholder_name with your card data. - If this error occurs, include the cardholder_name in your request. |
| 400 | 3001 | You must provide your cardissuer_id with your card data. - If you encounter this error, ensure the cardissuer_id is included in your request. |
| 400 | 3003 | Invalid card_token_id. - Ensure that the card_token_id is correct and has not been previously used. Try again. |
| 400 | 3004 | Invalid parameter site_id. - If this error occurs, ensure the site_id is valid and correctly formatted. |
| 400 | 3005 | Not valid action, the resource is in a state that does not allow this operation. For more information see the state that has the resource. - If you see this error, check the state of the resource and adjust your request accordingly. |
| 400 | 3006 | Invalid parameter cardtoken_id. - Ensure the cardtoken_id is correct and try again if this error appears. |
| 400 | 3007 | The parameter client_id cannot be null or empty. - If this error occurs, provide a valid client_id. |
| 400 | 3008 | Not found Cardtoken. - Verify the cardtoken information and try again if this error appears. |
| 400 | 3009 | Unauthorized client_id. - If this error occurs, check the client_id permissions and try again. |
| 400 | 3010 | Not found card on whitelist. - Ensure the card is on the whitelist if this error appears. |
| 400 | 3011 | Not found payment_method. - Verify the payment_method information and try again if this error occurs. |
| 400 | 3012 | Invalid parameter security_code_length. - Ensure the security_code_length parameter is correct if this error appears. |
| 400 | 3013 | The parameter security_code is a required field and cannot be null or empty. - If this error occurs, provide the security_code parameter. |
| 400 | 3014 | Invalid parameter payment_method. - Ensure the payment_method parameter is correct if this error appears. |
| 400 | 3015 | Invalid parameter card_number_length. - If this error occurs, ensure the card_number_length parameter is correct. |
| 400 | 3016 | Invalid parameter card_number. - Verify the card_number parameter and try again if this error appears. |
| 400 | 3017 | The parameter card_number_id cannot be null or empty. - Ensure the card_number_id parameter is provided if this error occurs. |
| 400 | 3018 | The parameter expiration_month cannot be null or empty. - Provide the expiration_month parameter if this error occurs. |
| 400 | 3019 | The parameter expiration_year cannot be null or empty. - Ensure the expiration_year parameter is provided if this error appears. |
| 400 | 3020 | The parameter cardholder.name cannot be null or empty. - Provide the cardholder.name parameter if this error occurs. |
| 400 | 3021 | The parameter cardholder.document.number cannot be null or empty. - Ensure the cardholder.document.number parameter is provided if this error appears. |
| 400 | 3022 | The parameter cardholder.document.type cannot be null or empty. - Provide the cardholder.document.type parameter if this error occurs. |
| 400 | 3023 | The parameter cardholder.document.subtype cannot be null or empty. - Ensure the cardholder.document.subtype parameter is provided if this error appears. |
| 400 | 3024 | Not valid action - partial refund unsupported for this transaction. - If this error occurs, note that partial refunds are not supported for this transaction. |
| 400 | 3025 | Invalid Auth Code. - Verify the Auth Code and try again if this error appears. |
| 400 | 3026 | Invalid card_id for this payment_method_id. - Ensure the card_id matches the payment_method_id if this error occurs. |
| 400 | 3027 | Invalid payment_type_id. - If this error appears, verify the payment_type_id and try again. |
| 400 | 3028 | Invalid payment_method_id. - Verify the payment_method_id and try again if this error occurs. |
| 400 | 3029 | Invalid card expiration month. - Ensure the card expiration month is valid if this error appears. |
| 400 | 3030 | Invalid card expiration year. - If this error occurs, verify the card expiration year and try again. |
| 400 | 3031 | Secure_code_id can't be null. - Ensure the secure_code_id is provided if this error appears. |
| 400 | 3032 | Invalid security_code_length 3033 3034 - Invalid card_number_validation. - If this error occurs, verify the security_code_length and card_number_validation. |
| 400 | 4000 | Token attribute can't be null. - Ensure the token attribute is provided if this error appears. |
| 400 | 4001 | Payment_method_id attribute can't be null. - If this error occurs, provide the payment_method_id attribute. |
| 400 | 4002 | Transaction_amount attribute can't be null. - Ensure the transaction_amount attribute is provided if this error appears. |
| 400 | 4003 | Transaction_amount attribute must be numeric. - Verify the transaction_amount is numeric if this error occurs. |
| 400 | 4004 | Installments attribute can't be null. - If this error appears, ensure the installments attribute is provided. |
| 400 | 4005 | Installments attribute must be numeric. - Ensure the installments attribute is numeric if this error occurs. |
| 400 | 4006 | Payer attribute is malformed. - Verify the payer attribute is correctly formatted if this error appears. |
| 400 | 4012 | Payer.id attribute can't be null. - If this error appears, ensure the payer.id attribute is provided. |
| 400 | 4013 | Payer.type attribute can't be null. - Ensure the payer.type attribute is provided if this error occurs. |
| 400 | 4015 | Payment_method_reference_id attribute can't be null. - Provide the payment_method_reference_id attribute if this error appears. |
| 400 | 4016 | Payment_method_reference_id attribute must be numeric. - Ensure the payment_method_reference_id attribute is numeric if this error occurs. |
| 400 | 4017 | Status attribute can't be null. - If this error appears, ensure the status attribute is provided. |
| 400 | 4018 | Payment_id attribute can't be null. - Provide the payment_id attribute if this error occurs. |
| 400 | 4019 | Payment_id attribute must be numeric. - Ensure the payment_id attribute is numeric if this error appears. |
| 400 | 4020 | Notification_url attribute must be a valid URL. - If this error occurs, provide a valid URL for the `notification_url` attribute that starts with `https://`. |
| 400 | 4021 | Notification_url attribute must be shorter than 500 characters. - Ensure the notification_url attribute is within the character limit if this error appears. |
| 400 | 4022 | Metadata attribute must be a valid JSON. - If this error occurs, ensure the metadata attribute is a valid JSON. |
| 400 | 4023 | Transaction_amount attribute can't be null. - Provide the transaction_amount attribute if this error appears. |
| 400 | 4024 | Transaction_amount attribute must be numeric. - Ensure the transaction_amount attribute is numeric if this error occurs. |
| 400 | 4025 | Refund_id can't be null. - Provide the refund_id if this error appears. |
| 400 | 4026 | Invalid coupon_amount. - Verify the coupon_amount is correct if this error occurs. |
| 400 | 4027 | Campaign_id attribute must be numeric. - Ensure the campaign_id attribute is numeric if this error appears. |
| 400 | 4028 | Coupon_amount attribute must be numeric. - Verify the coupon_amount attribute is numeric if this error occurs. |
| 400 | 4029 | Invalid payer type. - Ensure the payer type is valid if this error appears. |
| 400 | 4033 | Invalid installments. - Verify the installments parameter is correct if this error occurs. |
| 400 | 4037 | Invalid transaction_amount. - Ensure the transaction_amount is valid if this error appears. |
| 400 | 4038 | Application_fee cannot be bigger than transaction_amount. - If this error occurs, ensure the application_fee is less than or equal to the transaction_amount. |
| 400 | 4039 | Application_fee cannot be a negative value. - Ensure the application_fee is a positive value if this error appears. |
| 400 | 4050 | Payer.email must be a valid email. - If this error occurs, ensure the payer.email is a valid email address. |
| 400 | 4051 | Payer.email must be shorter than 254 characters. - Ensure the payer.email is within the character limit if this error appears. |
| 400 | 4292 | Header X-Idempotency-Key can’t be null. - Provide a valid X-Idempotency-Key header if this error occurs. |
| 400 | 6033 | User unavailable. - If this error appears, check the user status and try again. |
| 400 | 7523 | Invalid expiration date. - Ensure the expiration date is valid if this error occurs. |
| 401 | Unauthorized use of live credentials | This error occurs when the access token does not have the required 'payment' scope. Verify that the credentials are correct and have the appropriate permissions. |
| 403 | 4 | The caller is not authorized to access this resource. - If this error occurs, verify your access permissions. |
| 403 | 3002 | The caller is not authorized to perform this action. - If you see this error, ensure you have the necessary permissions to perform this action. |
| 403 | pa_unauthorized_result_from_policies | blocked_by PolicyAgent - At least one policy returned unauthorized - This error occurs when at least one policy returns 'unauthorized'. This can happen if the `authorization` header is removed during the request or if the Access Token is not sent. Please verify the submission of this information and try making a new request. |

## Request example

### cURL

```bash
curl -X POST \
  'https://api.mercadopago.com/v1/payments' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -d '{
  "additional_info": {
  "ip_address": "string",
  "items": [
  {
  "id": "MLB2907679857",
  "title": "Point Mini",
  "description": "Point product for card payments via Bluetooth.",
  "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
  "category_id": "electronics",
  "quantity": 1,
  "unit_price": "24.50",
  "type": "electronics",
  "event_date": "2023-12-31T09:37:52.000-04:00",
  "warranty": false,
  "category_descriptor": {
  "passenger": null,
  "route": null
  }
  }
  ],
  "payer": {
  "first_name": "María",
  "last_name": "González",
  "phone": {
  "area_code": "11",
  "number": "2323-5555"
  },
  "address": {
  "zip_code": "C1264AAK",
  "street_name": "Av das Nacoes Unidas",
  "street_number": "3039",
  "neighborhood": "Parque Patricios",
  "city": "3003",
  "federal_unit": "CABA"
  },
  "registration_date": "string",
  "is_prime_user": "string",
  "is_first_purchase_online": "string",
  "last_purchase": "string",
  "authentication_type": "Gmail"
  },
  "shipments": {
  "receiver_address": {
  "zip_code": "C1264AAK",
  "state_name": "Rio de Janeiro",
  "city_name": "Buzios",
  "street_name": "Av das Nacoes Unidas",
  "street_number": "3039",
  "floor": "string",
  "apartment": "string"
  },
  "width": 0,
  "height": 0,
  "express_shipment": "string",
  "pick_up_on_seller": "string"
  }
  },
  "application_fee": 0,
  "binary_mode": false,
  "callback_url": "string",
  "campaign_id": 0,
  "capture": false,
  "coupon_amount": 0,
  "coupon_code": "string",
  "description": "Payment for product",
  "differential_pricing_id": 0,
  "date_of_expiration": "string",
  "external_reference": "MP0001",
  "installments": 1,
  "issuer_id": "string",
  "metadata": {},
  "notification_url": "string",
  "payer": {
  "entity_type": "individual",
  "type": "customer",
  "id": 0,
  "email": "test@testuser.com",
  "identification": {
  "type": "DNI",
  "number": "12345678"
  },
  "first_name": "María",
  "last_name": "González"
  },
  "payment_method_id": "Debin_transfer",
  "statement_descriptor": "string",
  "token": "ff8080814c11e237014c1ff593b57b4d",
  "transaction_amount": "24.50"
  }'
```

### Node.js

```javascript
const client = new MercadoPago({ accessToken: '<ACCESS_TOKEN>' });
const payments = new Payment(client);

payments.create({
  body: {
  additional_info: {
  items: [
  {
  id: 'MLB2907679857',
  title: 'Point Mini',
  description: 'Point product for card payments via Bluetooth.',
  picture_url: 'https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png',
  category_id: 'electronics',
  quantity: 1,
  unit_price: 58,
  }
  ],
  payer: {
  first_name: 'Test',
  last_name: 'Test',
  phone: {
  area_code: '11',
  number: '987654321'
  },
  address: {
  street_number: null
  }
  },
  shipments: {
  receiver_address: {
  zip_code: '12312-123',
  state_name: 'Rio de Janeiro',
  city_name: 'Buzios',
  street_name: 'Av das Nacoes Unidas',
  street_number: 3003
  }
  }
  },
  application_fee: null,
  binary_mode: false,
  campaign_id: null,
  capture: false,
  coupon_amount: null,
  description: 'Payment for product',
  differential_pricing_id: null,
  external_reference: 'MP0001',
  installments: 1,
  metadata: null,
  payer: {
  entity_type: 'individual',
  type: 'customer',
  email: 'test@testuser.com',
  identification: {
  type: 'CPF',
  number: '95749019047'
  }
  },
  payment_method_id: 'master',
  token: 'ff8080814c11e237014c1ff593b57b4d',
  transaction_amount: 58
  },
  requestOptions: { idempotencyKey: '<SOME_UNIQUE_VALUE>' }
})
  .then((result) => console.log(result))
  .catch((error) => console.log(error));
```

### PHP

```php
MercadoPagoConfig::setAccessToken("ACCESS_TOKEN");

$client = new PaymentClient();
$request_options = new RequestOptions();
$request_options->setCustomHeaders(["X-Idempotency-Key: <SOME_UNIQUE_VALUE>"]);

$createRequest = [
  "additional_info" => [
  "items" => [
  [
  "id" => "MLB2907679857",
  "title" => "Point Mini",
  "description" => "Point product for card payments via Bluetooth.",
  "picture_url" => "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
  "category_id" => "electronics",
  "quantity" => 1,
  "unit_price" => 58,
  "type" => "electronics",
  "event_date" => "2023-12-31T09:37:52.000-04:00",
  "warranty" => false,
  "category_descriptor" => [
  "passenger" => [],
  "route" => []
  ]
  ]
  ],
  "payer" => [
  "first_name" => "Test",
  "last_name" => "Test",
  "phone" => [
  "area_code" => 11,
  "number" => "987654321"
  ],
  "address" => [
  "street_number" => null
  ],
  "shipments" => [
  "receiver_address" => [
  "zip_code" => "12312-123",
  "state_name" => "Rio de Janeiro",
  "city_name" => "Buzios",
  "street_name" => "Av das Nacoes Unidas",
  "street_number" => 3003
  ],
  "width" => null,
  "height" => null
  ]
  ],
  ],
  "application_fee" => null,
  "binary_mode" => false,
  "campaign_id" => null,
  "capture" => false,
  "coupon_amount" => null,
  "description" => "Payment for product",
  "differential_pricing_id" => null,
  "external_reference" => "MP0001",
  "installments" => 1,
  "metadata" => null,
  "payer" => [
  "entity_type" => "individual",
  "type" => "customer",
  "email" => "test@testuser.com",
  "identification" => [
  "type" => "CPF",
  "number" => "95749019047"
  ]
  ],
  "payment_method_id" => "master",
  "token" => "ff8080814c11e237014c1ff593b57b4d",
  "transaction_amount" => 58,
];

$client->create($createRequest, $request_options);
```

### Python

```python
import mercadopago
sdk = mercadopago.SDK("ENV_ACCESS_TOKEN")

request_options = mercadopago.config.RequestOptions()
request_options.custom_headers = {
	'x-idempotency-key': '<SOME_UNIQUE_VALUE>'
}

payment_data = {
	"application_fee": False,
	"binary_mode": False,
	"campaign_id": None,
	"capture": False,
	"coupon_amount": None,
	"description": "Payment for product",
	"differential_pricing_id": None,
	"external_reference": "MP0001",
	"installments": 1,
	"metadata": None,
	"payer": {
		"entity_type": "individual",
		"type": "customer",
		"email": "test@testuser.com",
		"identification": {
			"type": "CPF",
			"number": "95749019047"
		}
	},
	"payment_method_id": "master",
	"token": "ff8080814c11e237014c1ff593b57b4d",
	"transaction_amount": 58,
	"notification_url": "https://www.suaurl.com/notificacoes/",
	"sponsor_id": None,
	"binary_mode": False,
	"external_reference": "MP0001",
	"statement_descriptor": "MercadoPago",
	"additional_info": {
		"items": [
			{
				"id": "MLB2907679857",
				"title": "Point Mini",
				"description": "Point product for card payments via Bluetooth.",
				"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
				"category_id": "electronics",
				"type": "electronics",
				"quantity": 1,
				"unit_price": 58,
				"event_date": "2023-12-31T09:37:52.000-04:00",
				"warranty": False,
				"category_descriptor": {
					"passenger": {},
					"route": {}
				}
			}
		],
		"payer": {
			"first_name": "Test",
			"last_name": "Test",
			"address": {
				"zip_code": "06233-200",
				"street_name": "Av das Nacoes Unidas",
				"street_number": 3003
			},
			"phone": {
				"area_code": "11",
				"number": "987654321"
			}
		},
		"shipments": {
			"width": None,
			"height": None,
			"receiver_address": {
				"street_name": "Av das Nacoes Unidas",
				"street_number": 3003,
				"zip_code": "06233200",
				"city_name": "Buzios",
				"state_name": "Rio de Janeiro"
			}
		}
	}
}

payment_response = sdk.payment().create(payment_data, request_options)
payment = payment_response["response"]
```

### Java

```java
MercadoPagoConfig.setAccessToken("YOUR_ACCESS_TOKEN");

Map<String, String> customHeaders = new HashMap<>();
customHeaders.put("x-idempotency-key", "<SOME_UNIQUE_VALUE>");

MPRequestOptions requestOptions = MPRequestOptions.builder()
  .customHeaders(customHeaders)
  .build();

PaymentClient client = new PaymentClient();

List<PaymentItemRequest> items = new ArrayList<>();

PaymentItemRequest item =
  PaymentItemRequest.builder()
  .id("MLB2907679857")
  .title("Point Mini")
  .description("Point product for card payments via Bluetooth.")
  .pictureUrl(
  "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png")
  .categoryId("electronics")
  .quantity(1)
  .unitPrice(new BigDecimal("58.8"))
  .build();

items.add(item);

PaymentCreateRequest createRequest =
  PaymentCreateRequest.builder()
  .additionalInfo(
  PaymentAdditionalInfoRequest.builder()
  .items(items)
  .payer(
  PaymentAdditionalInfoPayerRequest.builder()
  .firstName("Test")
  .lastName("Test")
  .phone(
  PhoneRequest.builder().areaCode("11").number("987654321").build())
  .build())
  .shipments(
  PaymentShipmentsRequest.builder()
  .receiverAddress(
  PaymentReceiverAddressRequest.builder()
  .zipCode("12312-123")
  .stateName("Rio de Janeiro")
  .cityName("Buzios")
  .streetName("Av das Nacoes Unidas")
  .streetNumber("3003")
  .build())
  .build())
  .build())
  .binaryMode(false)
  .capture(false)
  .description("Payment for product")
  .externalReference("MP0001")
  .installments(1)
  .order(PaymentOrderRequest.builder().type("mercadolibre").build())
  .payer(PaymentPayerRequest.builder()
  .entityType("individual")
  .type("customer")
  .email("test@testuser.com")
  .identification(IdentificationRequest.builder()
  .type("CPF")
  .number("01234567890")
  .build())
  .build())
  .paymentMethodId("master")
  .token("ff8080814c11e237014c1ff593b57b4d")
  .transactionAmount(new BigDecimal("58.8"))
  .build();
client.create(createRequest, requestOptions);
```

### .Net

```csharp
MercadoPagoConfig.AccessToken = "ENV_ACCESS_TOKEN";

var requestOptions = new RequestOptions();
requestOptions.CustomHeaders.Add("x-idempotency-key", "<SOME_UNIQUE_VALUE>");

var item = new PaymentItemRequest
{
  Id = "MLB2907679857",
  Title = "Point Mini",
  Description = "Point product for card payments via Bluetooth.",
  PictureUrl = "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
  CategoryId = "electronics",
  Quantity = 1,
  UnitPrice = (decimal?)58.8,
  EventDate = "2023-12-31T09:37:52.000-04:00",
  Warranty = false,
  CategoryDescriptor = new PaymentCategoryDescriptorRequest
  {
  Passenger = {},
  Route = {}
  }
};

var payerInfo = new PaymentAdditionalInfoPayerRequest
{
  FirstName = "Test",
  LastName = "Test",
  Phone = new PhoneRequest
  {
  AreaCode = "11",
  Number = "987654321"
  },
  Address = new AddressRequest
  {
  StreetNumber = null
  }
};

var shipmentsInfo = new PaymentShipmentsRequest
{
  ReceiverAddress = new PaymentReceiverAddressRequest
  {
  ZipCode = "12312-123",
  StateName = "Rio de Janeiro",
  CityName = "Buzios",
  StreetName = "Av das Nacoes Unidas",
  StreetNumber = "3003"
  }

};

var additionalInfo = new PaymentAdditionalInfoRequest
{
  Items = new List<PaymentItemRequest> { item },
  Payer = payerInfo,
  Shipments = shipmentsInfo
};

var paymentPayerRequest = new PaymentPayerRequest
{
  Email = "test@testuser.com",
  FirstName = "Test",
  LastName = "User",
  Identification = new IdentificationRequest
  {
  Type = "CPF",
  Number = "01234567890",
  },
};

var request = new PaymentCreateRequest
{
  ApplicationFee = null,
  BinaryMode= false,
  CampaignId = null,
  Capture = false,
  CouponAmount = null,
  Description = "Payment for product",
  DifferentialPricingId = null,
  ExternalReference = "MP0001",
  Installments = 1,
  Metadata = null,
  NotificationUrl = null,
  Payer = paymentPayerRequest,
  PaymentMethodId = "master",
  StatementDescriptor = null,
  TransactionAmount = (decimal?)58.8,
  Token = "ff8080814c11e237014c1ff593b57b4d",
  AdditionalInfo = additionalInfo,
};

var client = new PaymentClient();
Payment payment = await client.CreateAsync(request, requestOptions);
```

### Ruby

```text
require 'mercadopago'

sdk = Mercadopago::SDK.new('YOUR_ACCESS_TOKEN')

custom_headers = {
 'x-idempotency-key': '<SOME_UNIQUE_VALUE>'
}

custom_request_options = Mercadopago::RequestOptions.new(custom_headers: custom_headers)

payment_object = {
  additional_info: {
  items: [
  {
  id: 'MLB2907679857',
  title: 'Point Mini',
  description: 'Point product for card payments via Bluetooth.',
  picture_url: 'https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png',
  category_id: 'electronics',
  quantity: 1,
  unit_price: 58,
  }
  ],
  payer: {
  first_name: 'Test',
  last_name: 'Test',
  phone: {
  area_code: '11',
  number: '987654321'
  },
  address: {
  street_number: nil
  }
  },
  shipments: {
  receiver_address: {
  zip_code: '12312-123',
  state_name: 'Rio de Janeiro',
  city_name: 'Buzios',
  street_name: 'Av das Nacoes Unidas',
  street_number: 3003
  },
  }
  },
  application_fee: nil,
  binary_mode: false,
  campaign_id: nil,
  capture: false,
  coupon_amount: nil,
  description: 'Payment for product',
  differential_pricing_id: nil,
  external_reference: 'MP0001',
  installments: 1,
  metadata: nil,
  payer: {
  entity_type: 'individual',
  type: 'customer',
  email: 'test@testuser.com',
  identification: {
  type: 'CPF',
  number: '95749019047'
  }
  },
  payment_method_id: 'master',
  token: 'ff8080814c11e237014c1ff593b57b4d',
  transaction_amount: 58
}

payment_response = sdk.payment.create(payment_object, custom_request_options)
payment_response[:response]
```

## Response example

```json
{
  "id": 20359978,
  "date_created": "2019-07-10T14:47:58.000Z",
  "date_approved": null,
  "date_last_updated": "2019-07-10T14:47:58.000Z",
  "date_of_expiration": "string",
  "money_release_date": null,
  "operation_type": "investment",
  "issuer_id": 25,
  "payment_method_id": "master",
  "payment_type_id": "credit_card",
  "status": "approved",
  "status_detail": "accredited",
  "currency_id": "ARS",
  "description": "Point Mini a maquininha que dá o dinheiro de suas vendas na hora.",
  "live_mode": false,
  "sponsor_id": "string",
  "authorization_code": "string",
  "money_release_schema": "string",
  "taxes_amount": 0,
  "counter_currency": "string",
  "shipping_amount": 0,
  "pos_id": "string",
  "store_id": "string",
  "collector_id": 448876418,
  "payer": {
  "id": 123,
  "email": "test@testuser.com",
  "identification": {
  "number": "12345678",
  "type": "DNI"
  },
  "type": "customer"
  },
  "metadata": {},
  "additional_info": {
  "items": [
  {
  "id": "PR0001",
  "title": "Point Mini",
  "description": "Producto Point para cobros con tarjetas mediante bluetooth",
  "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
  "category_id": "electronics",
  "quantity": 1,
  "unit_price": "24.50"
  }
  ],
  "payer": {
  "registration_date": "2019-01-01T15:01:01.000Z"
  },
  "shipments": {
  "receiver_address": {
  "street_name": "Av das Nacoes Unidas",
  "street_number": "3039",
  "zip_code": "C1264AAK",
  "city_name": "Buenos Aires",
  "state_name": "CABA"
  }
  }
  },
  "external_reference": "MP0001",
  "transaction_amount": "24.50",
  "transaction_amount_refunded": 50,
  "coupon_amount": 15,
  "differential_pricing_id": "string",
  "deduction_schema": "string",
  "transaction_details": {
  "payment_method_reference_id": "string",
  "net_received_amount": 56,
  "total_paid_amount": "50.00",
  "overpaid_amount": 0,
  "external_resource_url": "string",
  "installment_amount": 58,
  "financial_institution": "string",
  "payable_deferral_period": "string",
  "acquirer_reference": "string"
  },
  "fee_details": [
  {
  "type": "coupon_fee",
  "amount": 2,
  "fee_payer": "payer"
  }
  ],
  "captured": false,
  "binary_mode": false,
  "call_for_authorize_id": "string",
  "statement_descriptor": "MercadoPago",
  "installments": 1,
  "card": {
  "id": null,
  "first_six_digits": null,
  "last_four_digits": 5682,
  "expiration_month": null,
  "expiration_year": null,
  "date_created": null,
  "date_last_updated": null,
  "cardholder": {
  "name": null,
  "identification": {
  "number": "12345678",
  "type": "DNI"
  }
  }
  },
  "notification_url": "https://www.suaurl.com/notificacoes/",
  "processing_mode": "aggregator",
  "merchant_account_id": "string",
  "acquirer": "string",
  "merchant_number": "string",
  "point_of_interaction": {
  "type": "master",
  "sub_type": "string",
  "application_data": {
  "name": "NAME_SDK",
  "version": "VERSION_NUMBER"
  },
  "transaction_data": {
  "qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAABRQAAAUUCAYAAACu5p7oAAAABGdBTUEAALGPC/xhBQAAAAFzUkdCAK7OHOkAAAAgY0hSTQAAeiYAAICEAAD6AAAAgOgAAHUwAADqYAAAOpgAABdwnLpRPAAAIABJREFUeJzs2luO3LiWQNFmI+Y/Zd6vRt36KGNXi7ZOBtcagHD4kNLeiLX33v8DAAAAABD879sDAAAAAAA/h6AIAAAAAGSCIgAAAACQCYoAAAAAQCYoAgAAAACZoAgAAAAAZIIiAAAAAJAJigAAAABAJigCAAAAAJmgCAAAAABkgiIAAAAAkAmKAAAAAEAmKAIAAAAAmaAIAAAAAGSCIgAAAACQCYoAAAAAQCYoAgAAAACZoAgAAAAAZIIiAAAAAJAJigAAAABAJigCA...",
  "ticket_url": "https://www.mercadopago.com.br/payments/123456789/ticket?caller_id=123456&hash=123e4567-e89b-12d3-a456-426655440000"
  }
  }
}
```