Recursos para IA
Crear pagohttps://api.mercadopago.com/v1/advanced_payments
Este endpoint crea un advanced payment para Wallet Connect. Durante el proceso de vinculación, el integrador recibe un token de pago del comprador. Este token permite que el integrador realice el pago directamente desde la billetera del comprador. Para aplicar descuentos, crea una promesa de descuento antes de usar este endpoint. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
Request parameters
Header
Authorization
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.string
REQUERIDO
X-Idempotency-Key
Esta función permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores, como la creación de dos pagos idénticos, por ejemplo. Para string
REQUERIDO
X-Meli-Session-Id
Identificador del dispositivo utilizado para mejorar la seguridad y aumentar la tasa de aprobación del pago. Representa un identificador único para el dispositivo del comprador en el momento de la compra.string
Body
wallet_payment
Datos del pago de un vendedor con una vinculación previa de Wallet Connect.object
REQUERIDO
payer
Información del comprador necesaria para procesar el pago.object
REQUERIDO
binary_mode
Cuando está activado, el pago solo puede ser aprobado o rechazado. De lo contrario, el pago puede quedar pendiente.boolean
capture
Indica si el pago debe capturarse inmediatamente. En pagos de dos pasos, envía "false" para reservar el monto primero y luego captúralo enviando "true" en una solicitud separada.boolean
Response parameters
id
Identificador único del advanced payment.number
payments
Lista de pagos generados dentro del advanced payment.array
wallet_payment
Datos del pago de billetera de un vendedor con vinculación previa de Wallet Connect.object
disbursements
Lista de desembolsos distribuidos entre los vendedores.array
Errors
400Error de solicitud.
empty_required_header
El header "X-Idempotency-Key" es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo.
500Error de procesamiento.
internal_error
Ocurrió un error de nuestra parte al intentar procesar la solicitud. Por favor, inténtalo nuevamente más tarde.
Request
curl -X POST \
'https://api.mercadopago.com/v1/advanced_payments'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: 153dd842-4fbc-480e-8552-5129b8e1bca9' \
-H 'X-Meli-Session-Id: DEVICE_ID' \
-d '{
"wallet_payment": {
"transaction_amount": 24.5,
"description": "Payment for the purchase of furniture",
"external_reference": "Payment_seller_123",
"statement_descriptor": "descriptor",
"forward_data": {
"sub_merchant": {
"sub_merchant_id": 123123,
"mcc": "5462",
"country": "CO",
"address_door_number": 93,
"zip": "110221",
"document_number": "222222222222222",
"city": "Bogotá",
"address_street": "RUA A",
"legal_name": "LOJINHA DO ZÉ",
"region_code_iso": "BR-MG",
"region_code": "BR",
"document_type": "NIT",
"url": "www.nomedofacilitador.com.br"
}
},
"discount": {
"amount": 10,
"description": "DESC20",
"detail": {
"cap": 1000000,
"type": "percentage",
"value": 10
}
}
},
"payer": {
"token": "abcdef1e23f4567d8e9123eb6591ff68df74c57930551ed980239f4538a7e530",
"type_token": "wallet-tokens"
},
"binary_mode": false,
"capture": false
}'Response
{
"id": 10267812,
"payments": [
{
"id": 3870106238,
"status_detail": "accredited",
"payment_method_id": "credit_card",
"transaction_amount": "24.50",
"installments": 1,
"description": "Payment for the purchase of furniture",
"capture": true,
"external_reference": "payment_123"
}
],
"wallet_payment": {
"transaction_amount": "24.50",
"description": "Payment for the purchase of furniture",
"external_reference": "Payment_seller_123",
"discount": {
"amount": 10,
"code": "WALLET10"
}
},
"disbursements": [
{
"collector_id": "collectorId"
}
],
"payer": {
"id": 8879
},
"site_id": "MCO",
"binary_mode": true,
"date_created": "2018-10-20T09:34:20.518-04:00",
"date_last_updated": "2018-10-20T09:34:20.518-04:00"
}