Cobrar con Mercado Pago

Si tu app cobra, no armás la integración con Mercado Pago desde cero: conectás tu cuenta al proyecto y creás los cobros con una llamada a la API. El dinero va directo a tu cuenta de Mercado Pago.

Cada proyecto cobra con su propia cuenta

Forja no intermedia el dinero ni lo toca. Cada proyecto usa las credenciales de la cuenta de Mercado Pago que vos conectes. Esas credenciales solo las puede cargar, cambiar o borrar el dueño del proyecto.

1. Conectá tu cuenta

En el proyecto, andá a la sección Mercado Pago y tocá Cargar credenciales. Necesitás dos datos, que sacás del panel de Mercado Pago Developers, en "Tus integraciones":

Access token de la cuenta.
Webhook secret. No es el access token: es un secreto aparte que Mercado Pago genera para firmar los avisos de pago. Forja lo usa para comprobar que cada aviso viene de verdad de Mercado Pago.

La integración con Mercado Pago depende de tu plan: el plan Free no la incluye, Starter la incluye en un proyecto y Growth en todos. Mirá Precios.

2. Creá un cobro

Desde tu servidor, llamá a POST /v1/payments con una llave que tenga el permiso Cobros. Los campos son:

Campo	Para qué sirve
`externalReference`	Tu propio identificador del pedido. Después lo usás para consultar el estado.
`description`	Lo que ve quien paga ("Corte de pelo + barba").
`amount`	El monto, un número mayor que cero.
`currency`	Opcional. Código de moneda de tres letras. Depende de lo que procese tu cuenta de Mercado Pago.
`successUrl`, `failureUrl`	Opcionales. A dónde vuelve la persona después de pagar, o si falla.

Terminal

curl -X POST "https://api.getforja.site/v1/payments" \
  -H "Authorization: Bearer <TU_LLAVE_CON_PERMISO_COBROS>" \
  -H "Content-Type: application/json" \
  -d '{
    "externalReference": "pedido-1042",
    "description": "Corte de pelo + barba",
    "amount": 12000,
    "successUrl": "https://tuapp.com/gracias",
    "failureUrl": "https://tuapp.com/error"
  }'

La respuesta trae el paymentId, el status inicial y dos enlaces: checkoutUrl, adonde mandás a tu cliente para que pague en el checkout de Mercado Pago, y sandboxCheckoutUrl, para probar con cuentas de prueba de Mercado Pago.

Respuesta

{
  "paymentId": "…",
  "status": "PENDING",
  "checkoutUrl": "https://www.mercadopago.com.ar/checkout/…",
  "sandboxCheckoutUrl": "https://sandbox.mercadopago.com.ar/checkout/…"
}

3. Consultá el estado

Terminal

curl "https://api.getforja.site/v1/payments/pedido-1042" \
  -H "Authorization: Bearer <TU_LLAVE_CON_PERMISO_COBROS>"

El estado de un cobro puede ser APPROVED, REJECTED, PENDING, CANCELLED oREFUNDED. Forja lo actualiza solo cuando Mercado Pago le avisa, así que no hace falta que lo consultes en un ciclo.

La llave de cobros va solo en tu servidor. Con ella se crean cobros a nombre de tu cuenta. Nunca la pongas en el código de una página. Solo el dueño del proyecto puede crear llaves con este permiso, y las de staging no pueden tenerlo.

Qué no cubre

Esta integración sirve para cobros únicos a tus clientes. Forja no ofrece, por ahora, suscripciones recurrentes para tu app, ni emisión de comprobantes fiscales por cuenta tuya. Tu responsabilidad fiscal frente a tus clientes sigue siendo tuya.

Información revisada el 2026-10-24.