MakePay commercetools Connector

Node service for integrating MakePay hosted payment links with commercetools Composable Commerce Payments.

Features

• HTTP endpoint for commercetools Payment API Extensions.
• Creates MakePay payment links from Payment amount and cart/order metadata.
• Returns commercetools update actions for interfaceId and custom fields.
• Verifies MakePay webhooks with X-MakePay-Signature.
• Designed to run as a regular HTTPS service or a future commercetools Connect service application.

API Extension Endpoint

POST /commercetools/extensions/payments

Configure a commercetools API Extension for Payments create/update triggers. The Payment custom type should include:

• makepayPaymentLinkUrl
• makepayPaymentLinkUid

Environment

MAKEPAY_KEY_ID=...
MAKEPAY_KEY_SECRET=...
MAKEPAY_WEBHOOK_SECRET=...
MAKEPAY_BASE_URL=https://www.makecrypto.io
MAKEPAY_RETURN_URL=https://shop.example.com/payment-return

commercetools Direction

commercetools recommends API Extensions for synchronous validation/update flows and Subscriptions for asynchronous event processing. This connector keeps the synchronous path small and only returns Payment update actions.

• API Extensions
• Connect
• Payments API

Development

npm test
npm run validate