MercadoPago API Template | |
---|---|
β‘οΈ | Launch your api instantly watching changes with live-reload |
π | Highly scalable using Repository design pattern to access the database even easier |
π | OpenAPI with Swagger to describe your RESTful APIs |
β¨ | KISS principle make everything as simple as possible, but not simpler |
π± | Mobile friendly supporting Cross-origin resource sharing (CORS) with a list of domains for restricted resources |
π | Security using JWT authentication strategy with Passport and other techniques to increase the security of your applications |
π₯ | Made for Users. Easily validate permissions for specific routes using Guards with a Role-based access control |
β± | Don't repeat yourself, Single responsibility principle. |
π | Validation: provides pipes available right out-of-the-box with class-validator to enforce validation rules for all incoming client payloads |
Logger with Winston using different levels to track exceptions easily | |
π | Migrations using TypeORM to apply incremental updates to the database |
Link: https://mercadopago-e-commerce.herokuapp.com/ecommerce
Son las claves que MercadoPago proporciona para poder configurar tus integraciones, es una llave que identifica a tu usario (No compartir). Ejemplo:
- Public Key
- Access Token
- Client ID (Used with SDKs or plugins)
- Client Secret (Used with SDKs or plugins)
Link: https://www.mercadopago.com.co/settings/account/credentials
Es un dato obligatorio. Sirven para validar la identidad de la cuenta por medio de un token.
Permite iniciar el proceso de pago, al crear una preferencia se obtiene una url init_point
para redireccionar los usuarios a un flujo de checkout.
Al finalizar el proceso de pago se recibe una notificaciΓ³n por medio de un Webhook que se configura en la creaciΓ³n de la preferencia, con una url notification_url
de la API de nuestro negocio.
Link: https://www.mercadopago.com.co/developers/es/reference/preferences/_checkout_preferences/post
Es necesario definir un endpoint donde se notificarΓ‘ el resultado del proceso de pago. La notificaciΓ³n se realizarΓ‘ a un Webhook el cual es un POST request unidireccional que MercadoPago envΓa a nuestro endpoint definido al momento de crear la preferencia de pago.
Acciones:
payment.created
: Pago creado, pendiente de pago.payment.updated
: Pago aprobado o rechazado.
Es necesario retornar un HTTP Status 200 (OK) o 201 (Created), de lo contrario MercadoPago seguirΓ‘ reintentando notificar el cambio con su polΓtica de reintentos hasta 4 dΓas despuΓ©s del primer intento mediante una cola de notificaciones.
Las notificaciones tambiΓ©n se pueden configurar de manera global en el panel de desarrolladores, tanto para modo Sandbox como ProducciΓ³n.
Link: https://www.mercadopago.com.co/developers/es/guides/notifications/webhooks
Reflejan los estados finales de una transacciΓ³n, las urls a la que serΓ‘n redireccionados nuestros usuarios:
success
: Pagos Γ©xitosos.failure
: Pagos rechazados.pending
: Pagos en estado pendiente.
auto_return
: ParΓ‘metro por el cual se puede habilitar el retorno automΓ‘tico segΓΊn el estado de la transacciΓ³n.
Se permite realizar devoluciones parciales (en el caso de ingresar un monto menor al total del pago) o totales independientemente del medio de pago.
Link: https://www.mercadopago.com.co/developers/es/guides/manage-account/account/cancellations-and-refunds
Es posible establecer medios de pago no soportados dependiendo del paΓs, ademΓ‘s de obtener la informaciΓ³n de montos mΓnimos y mΓ‘ximos soportados por cada medio de pago.
Link: https://www.mercadopago.com.co/developers/es/guides/resources/localization/payment-methods
Existen consideraciones de impuestos diferentes por paΓs, estos son establecidos en el momento de crear la preferencia de pago. MercadoPago es un agente de retenciΓ³n y por defecto aplica retenciΓ³n sobre el 19% de la base del monto total de la preferencia generada a menos que se indique lo contrario en la creaciΓ³n de la preferencia.
Ivas en Colombia:
- 0%
- 5%
- 15%
- 19% (Defecto)
Link: https://www.mercadopago.com.co/developers/es/guides/resources/localization/iva-colombia
- IntegraciΓ³n QR - Postman API Collection
- Checkout Pro
- Checkout API
- Mobile Checkout
- sandbox_init_point: Url usada para emular un flujo de pago por medio de una redirecciΓ³n de nuestros usuarios con tarjetas de prueba.
# install dependencies
$ yarn
# development
$ yarn start
# watch mode
$ yarn start:dev
# production mode
$ yarn start:prod
# run migration
$ yarn migration
# create migration
$ yarn migration:create
# revert migration
$ yarn migration:revert
# unit tests
$ yarn test
# e2e tests
$ yarn test:e2e
# test coverage
$ yarn test:cov
- typescript-starter: Nest framework TypeScript starter repository.
- Mercado Pago SDK for NodeJS
I believe in Unicorns π¦ Support me, if you do too.
Donate Ethereum, ADA, BNB, SHIBA, USDT, DOGE:
Wallet address: 0x3F9fA8021B43ACe578C2352861Cf335449F33427
Please let us know your contributions! π
Made with β€οΈ