GraphQL module
Introducing Buckaroo's revolutionary GraphQL extension for the Buckaroo Magento 2 Payments Plugin—an essential enhancement for our cutting-edge Hyvä React checkout extension. GraphQL is a powerful query language for APIs, providing a comprehensive and understandable description of your API's data. Clients can request exactly what they need, optimizing performance and enabling easy API evolution over time. Unlock new e-commerce efficiency and flexibility with Buckaroo's latest innovation. Upgrade your online business experience today!
Requirements
To utilize the plugin, you must use:
- Magento Open Source version 2.4.x
- Buckaroo Magento 2 Payment plugin v1.43.0 or higher.
Installation
Install the GraphQL module using Composer:
- Install the Module:
composer require buckaroo/magento2graphql
- Enable the Module:
php bin/magento module:enable Buckaroo_Magento2Graphql
- Apply Database Updates:
php bin/magento setup:upgrade
- Flush the Cache:
php bin/magento cache:flush
Usage
Example requests
Get Available Payment Methods with Additional Data for Gateways:
query {
cart(cart_id: "{ CART_ID }") {
available_payment_methods {
code
title
buckaroo_additional {
key
values {
name
code
img
}
value
}
}
}
}
Place order request example: In order to place a order you will need to the following 3 steps:
- Set the payment method on the cart with the required additional parameters using the default
setPaymentMethodOnCart
and thebuckaroo_additional
property. - Set the return URL using our custom migration
setBuckarooReturnUrl
required for the payment engine to redirect back to your application after the payment was completed/cancelled/failed. - Finally, execute the default
placeOrder
will return a redirect URL for the payment engine to complete the payment. For iDEAL we have the following example:
For iDEAL we have the following example:
mutation doBuckarooPayment(
$cartId: String!
$returnUrl: String!
$methodCode: String!
) {
setPaymentMethodOnCart(
input: {
cart_id: $cartId
payment_method: {
code: $methodCode
buckaroo_additional: { buckaroo_magento2_ideal: { issuer: "ABNANL2A" } }
}
}
) {
cart {
items {
product {
name
sku
}
}
}
}
setBuckarooReturnUrl(input: { return_url: $returnUrl, cart_id: $cartId }) {
success
}
placeOrder(input: { cart_id: $cartId }) {
order {
order_number
buckaroo_additional {
redirect
transaction_id
data {
key
value
}
}
}
}
}
After this process, store the buckaroo transaction_id
and redirect the user to complete the payment.
Retrieve Payment Status
To get the payment status after the user is redirected back, use our custom mutation buckarooPaymentTransactionStatus
with the stored transaction_id
:
mutation buckarooPaymentTransactionStatus(input: { transaction_id: "E397CF4C24E64AA299F45246F9906F45" }) {
payment_status,
status_code
}
Updated 8 days ago