README

Magento 2的MultiSafepay插件（GraphQL模块）

本模块为MultiSafepay支付提供GraphQL支持。要安装所有功能，请查看我们的元包。

安装

本模块可以通过composer安装

composer require multisafepay/magento2-graphql

接下来，启用模块

bin/magento module:enable MultiSafepay_ConnectCore MultiSafepay_ConnectFrontend MultiSafepay_ConnectAdminhtml MultiSafepay_ConnectGraphQl

接下来，运行以下命令

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

请注意，安装此模块后，您将仅拥有GraphQL兼容性和核心功能。

为了快速安装所有模块，我们建议使用元包。

用法

要使用GraphQL创建订单，请参阅Magento手册

示例请求

• 获取所选MultiSafepay支付的发行机构和附加数据

query {
    cart(cart_id: "{ CART_ID }") {
        selected_payment_method {
            code
            multisafepay_additional_data {
                image
                is_preselected
            }
            multisafepay_available_issuers {
                code
                description
            }
        }
    }
}

• 获取MultiSafepay网关的可用支付方式及其发行机构和附加数据

query {
    cart(cart_id: "{ CART_ID }") {
        available_payment_methods {
            code
            title
            multisafepay_available_issuers {
                code
                description
            }
            multisafepay_additional_data {
                image
                is_preselected
            }
        }
    }
}

• 使用发行机构的setPaymentMethodOnCart查询示例

mutation {
    setPaymentMethodOnCart(input: {
        cart_id: "{ CART_ID }"
        payment_method: {
            code: "multisafepay_mybank"
            multisafepay_mybank: {
                issuer_id: "CT000003-it-1"
            }
        }
    }) {
        cart {
            selected_payment_method {
                code
                multisafepay_additional_data {
                    image
                    is_preselected
                }
            }
        }
    }
}

• 要检索包含支付组件、Apple Pay或/和Google Pay信息的MultiSafepay请求数据，可以使用以下查询

query MultisafepayPaymentRequestData {
    multisafepayPaymentRequestData(cart_id: { CART_ID }) {
        apiToken
        apiTokenLifeTime
        cartTotal
        currency
        environment
        locale
        paymentComponentContainerId
        payment_component_template_id
        storeId
        applePayButton {
            applePayButtonId
            getMerchantSessionUrl
            isActive
            additionalTotalItems {
                amount
                label
            }
            cartItems {
                label
                price
            }
        }
        googlePayButton {
            accountId
            googlePayButtonId
            isActive
            mode
            merchantInfo {
                merchantId
                merchantName
            }
        }
        paymentComponentConfig {
            gatewayCode
            paymentMethod
            paymentType
            additionalInfo {
                image
                is_preselected
                vaultCode
            }
            tokens {
                bin
                code
                display
                expired
                expiry_date
                last4
                model
                name_holder
                token
            }
        }
    }
}

• 使用支付组件有效载荷的setPaymentMethodOnCart查询示例：（有关如何检索有效载荷的更多信息，请参阅MultiSafepay文档）

mutation {
    setPaymentMethodOnCart(input: {
        cart_id: "{ CART_ID }"
        payment_method: {
            code: "multisafepay_creditcard"
            multisafepay_creditcard: {
                payload: "xxxx"
                tokenize: true
            }
        }
    }) {
        cart {
            selected_payment_method {
                code
                multisafepay_additional_data {
                    image
                    is_preselected
                }
            }
        }
    }
}

• 下单请求示例。下单后，您将收到multisafepay_payment_url，客户应被重定向到该URL进行交易

mutation {
    placeOrder(input: {cart_id: "{ CART_ID }"}) {
        order {
            order_number
            multisafepay_payment_url {
                payment_url
                error
            }
        }
    }
}

• 用于在支付失败后通过购物车ID恢复报价的restoreQuote新突变请求示例

mutation {
    restoreQuote(input: {
        cart_id: "{ CART_ID }"
        } 
    )

• 从已下单的订单获取MultiSafepay支付URL

query {
    customer {
        orders(
            pageSize: 10
        ) {
            total_count
            items {
                id
                increment_id
                multisafepay_payment_url
            }
        }
    }
}

支持

您可以在我们的仓库中创建问题。如果您需要任何额外的帮助或支持，请联系integration@multisafepay.com

我们还在我们的Magento Slack频道上#multisafepay-payments。请随时开始对话或提供改进我们Magento 2插件的建议。

贡献礼物

我们期待您的反馈。您是否看到了改进的机会？我们邀请您在GitHub上创建拉取请求。您是否缺少某些内容并希望我们修复它？通过发送电子邮件或创建问题来提出改进建议。

您将获得什么？一款全新的MultiSafepay T恤，让您成为团队的一员！

许可证

开放软件许可（OSL 3.0）

想成为团队的一员吗？

您是想要在MultiSafepay工作的开发者吗？查看我们的职位空缺，并请随时与我们联系。