Name

Last name

E-mail

``` Copiar \## Get document types After configuring the credential, it is necessary to obtain the types of documents that will be part of filling out the payment form. By including the element of type \`select\` with the id: id = \`docType\` that is on the form, it will be possible to automatically fill in the available options when calling the following function: * [javascript ](#editor%5F12) javascript ``` (async function getIdentificationTypes() { try { const identificationTypes = await mp.getIdentificationTypes(); const identificationTypeElement = document.getElementById('form-checkout__identificationType'); createSelectOptions(identificationTypeElement, identificationTypes); } catch (e) { return console.error('Error getting identificationTypes: ', e); } })(); function createSelectOptions(elem, options, labelsAndKeys = { label: "name", value: "id" }) { const { label, value } = labelsAndKeys; elem.options.length = 0; const tempOptions = document.createDocumentFragment(); options.forEach(option => { const optValue = option[value]; const optLabel = option[label]; const opt = document.createElement('option'); opt.value = optValue; opt.textContent = optLabel; tempOptions.appendChild(opt); }); elem.appendChild(tempOptions); } ``` Copiar \## Send payment When finalizing the inclusion of the payment form and obtaining the types of documents, it is necessary to forward the buyer's email, type and document number, the payment method used and the details of the amount to be paid using our \*\*Payments API\*\* or one of our \*\*SDKs\*\*. To configure payments via \*\*SPEI Transfers\*\*, send a \*\*POST\*\* with the following parameters to the endpoint \[/v1/payments\](https://www.mercadopago.com.mx/developers/en/reference/online-payments/checkout-api-payments/create-payment/post) and run the request or, if you prefer, use one of our SDKs below. * [csharp ](#editor%5F17) * [curl ](#editor%5F19) * [java ](#editor%5F15) * [node ](#editor%5F14) * [php ](#editor%5F13) * [python ](#editor%5F18) * [ruby ](#editor%5F16) php node java ruby csharp python curl ``` transaction_amount = 5000; $payment->description = "Título del producto"; $payment->payment_method_id = "clabe"; $payer = new MercadoPago\Payer(); $payer->email = $_POST['email']; $payer->first_name = $_POST['payerFirstName'] $payer->last_name = $_POST['payerLastName'] $payer->entity_type = "individual"; $payment->payer = $payer; $payment->save(); $response = array( 'status' => $payment->status, 'payment_link' => $payment->transaction_details->external_resource_url, 'id' => $payment->id ); echo json_encode($response); ?> ``` Copiar ``` const mercadopago = require('mercadopago'); mercadopago.configurations.setAccessToken(config.access_token); var payment = req.body; var payment_data = { transaction_amount: 5000, description: 'Título del producto', payment_method_id: 'clabe', payer: { entity_type: 'individual', email: payment.email, first_name: payment.payerFirstName, last_name: payment.payerLastName } }; var payment = mercadopago.payment.save(payment_data) .then(function(response) { res.status(response.status).json({ status: response.body.status, status_detail: response.body.status_detail, id: response.body.id, }); }) .catch(function(error) { res.status(error.status).send(error); }); var payment_link = payment.transaction_details.external_resource_url; ``` Copiar ``` MercadoPagoConfig.setAccessToken("YOUR_ACCESS_TOKEN"); PaymentClient client = new PaymentClient(); PaymentPayerRequest payer = PaymentPayerRequest.builder() .type("customer") .email(request.getEmail()) .firstName(request.getPayerFirstName()) .lastName(request.getPayerLastName()) .entityType("individual") .build(); PaymentCreateRequest paymentCreateRequest = PaymentCreateRequest.builder() .transactionAmount(new BigDecimal(5000)) .description("description") .paymentMethodId("clabe") .payer(payer) .build(); Payment payment = client.create(paymentCreateRequest); String paymentLink = payment.transactionDetails.externalResourceUrl; ``` Copiar ``` require 'mercadopago' sdk = Mercadopago::SDK.new('ACCESS_TOKEN') payment_data = { transaction_amount: 5000, description: "description", payment_method_id: "clabe", payer: { type: "customer", email: params[: email], entity_type: "individual", first_name: params[: payerFirstName] last_name: params[: payerLastName] } } payment_response = sdk.payment.create(payment_data) payment = payment_response[: response] payment_link = payment.transaction_details.external_resource_url; ``` Copiar ``` using System; using MercadoPago.Client.Common; using MercadoPago.Client.Payment; using MercadoPago.Config; using MercadoPago.Resource.Payment; MercadoPagoConfig.AccessToken = "ACCESS_TOKEN"; var client = new PaymentClient(); var payer = new PaymentPayerRequest() { Type = "customer", Email = request.Email, EntityType = "individual", FirstName = request.PayerFirstName, LastName = request.PayerLastName }; var paymentCreateRequest = new PaymentCreateRequest() { TransactionAmount = 5000, Description = "description", PaymentMethodId = "clabe", AdditionalInfo = additionalInfo, CallbackUrl = "https://your-site.com", Payer = payer }; var payment = await client.CreateAsync(paymentCreateRequest); var paymentLink = payment.TransactionDetails.externalResourceUrl; ``` Copiar ``` import mercadopago sdk = mercadopago.SDK("ACCESS_TOKEN") payment_data = { "transaction_amount": 5000, "description": "description", "payment_method_id": "clabe", "payer": { "type": "customer", "email": request.POST.get("email"), "entity_type": "individual", "first_name": request.POST.get("first_name"), "last_name": request.POST.get("last_name"), } } payment_response = sdk.payment().create(payment_data) payment = payment_response["response"] Payment_link = payment.transaction_details.external_resource_url ``` Copiar ``` curl --location --request POST 'https://api.mercadopago.com/v1/payments' \ -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ --d '{ "transaction_amount": 5000, "description": "Título del producto", "payment_method_id": "clabe", "payer": { "email": "test_user_mx@testuser.com", "entity_type": "individual", "first_name": "John", "last_name": "Doe" } }' ``` Copiar The response will show the \`pending\` status until the buyer completes the payment. Also, in the response to the request, the \`payment\_method.data.external\_resource\_url\` parameter will return a URL that contains instructions for the buyer to make the payment. You can redirect to this same link to complete the payment flow. See below for an example response. * [json ](#editor%5F20) json ``` { "id": 51096146182, "version": null, "date_created": "2023-05-10T13:43:14.586-04:00", ... "payment_method_id": "clabe", "payment_type_id": "bank_transfer", "payment_method": { "id": "clabe", "type": "bank_transfer", "data": { "reference_id": "6410293433784980810", "external_reference_id": "1009", "external_resource_url": "https://www.mercadopago.com.mx/payments/51096146182/ticket?caller_id=34728475&hash=f3a8630a-f06a-48e4-b2a6-f95750af7346" } }, "status": "pending", ... } ``` Copiar \> NOTE > > If you receive an error while generating a payment, please refer to the list of possible errors in the \[API Reference\](https://www.mercadopago.com.mx/developers/en/reference/online-payments/checkout-api-payments/create-payment/post) section. ## Payment visualization In order for the user to make the transfer, direct them directly to the URL available at \`external\_resource\_url\` or make it available through a button, following the example below. * [html ](#editor%5F21) html ``` Pay with SPEI Transfers ``` Copiar