¿Qué documentación quieres buscar?
¿No sabes cómo empezar la integración?
Accede a los primeros pasos¿Te sirvió esta información?
Sí
No
Crear un Advanced Payment/v1/advanced_paymentsLos Advanced Payments son pagos específicos para Wallet Connect. Durante el proceso del agreement, el integrador recibe un "payer token" del pagador. Este token permite que el integrador realice el pago directamente desde la billetera del pagador. Si desea aplicar descuentos, primero es necesario crear una promesa de descuento antes de utilizarlos.
POST
Productos que lo utilizan:
Parámetros para la solicitud
binary_mode
Localización: bodyCuando el pago está activado, solo puede ser aprobado o rechazado. De lo contrario, el pago puede estar pendiente.boolean
capture
Localización: bodyEs un campo booleano que se encuentra en pagos de dos pasos (como tarjeta de débito). En este tipo de pago, que se realiza de forma asíncrona, primero se reserva el valor de la compra (capture = false). Esta cantidad se captura y no se debita de la cuenta al instante. Cuando el dinero se transfiere realmente al cobrador (que recibe el pago), se captura la cantidad (capture = true).boolean
payerobject
Localización: bodyInformación del pagador requerida para crear el advanced payment.REQUERIDO
wallet_paymentobject
Localización: bodyIndica que es un advanced payment de un vendedor con una vinculación previa de Wallet Connect.REQUERIDO
Parámetros de respuesta
id
Localización: bodyID único que identifica el advanced payment.number
payments
Localización: bodyListado de pagos.array
wallet_paymentobject
Localización: bodyIndica que es un advanced payment de un vendedor con una vinculación previa de Wallet Connect.REQUERIDO
disbursements
Localización: bodyarray
Solicitud
curl
curl -X POST \
'https://api.mercadopago.com/v1/advanced_payments' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN \
-H 'Content-Type: application/json' \
-d '{
"wallet_payment": {
"transaction_amount": 125.98,
"description": "Payment for the purchase of furniture",
"external_reference": "Payment_seller_123",
"discount": {
"amount": 10,
"description": "DESC20",
"code": "WALLET10",
"detail": {
"cap": 1000000,
"type": "percentage",
"value": 10
}
}
},
"payer": {
"token": "abcdef1e23f4567d8e9123eb6591ff68df74c57930551ed980239f4538a7e530",
"type_token": "wallet-tokens"
},
"binary_mode": false,
"capture": true
}'
Respuesta
json
{
"id": 10267812,
"payments": [
{
"id": 3870106238,
"status_detail": "approved_id",
"payment_method_id": "credit_card_id",
"transaction_amount": 700.5,
"installments": 1,
"description": "Payment for the purchase of furniture",
"capture": true,
"external_reference": "payment_123"
}
],
"wallet_payment": {
"transaction_amount": 125.98,
"description": "payment of a bussines trip",
"external_reference": "Payment_seller_123",
"discount": {
"amount": 10,
"code": "WALLET10"
}
},
"disbursements": [
{
"collector_id": "collectorId"
}
],
"payer": {
"id": 8879
},
"site_id": "MLA",
"binary_mode": true,
"date_created": "2018-10-20T09:34:20.518-04:00",
"date_last_updated": "2018-10-20T09:34:20.518-04:00"
}
Errores
400bad_request
400
400Invalid capture payment status
400Some of the payment methods don't support deferred capture
400Field payment_type_id is required.
400Maximum disbursements allowed is 100
400Field id must not be blank
400external_reference is required.
400Invalid payer token.
500bad_request
500Internal server error
500Internal Error in Discarded List.