buckaroo / magento2graphql
Buckaroo Magento2 GraphQL Support
Installs: 13 650
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 11
Forks: 1
Type:magento2-module
Requires
- buckaroo/magento2: >=1.52.1
This package is auto-updated.
Last update: 2025-07-22 13:38:12 UTC
README
Buckaroo Magento2 GraphQL extension
We created a additional GraphQL extension for our Buckaroo Magento 2 Payments Plugin.
This plugin is needed for our Hÿva React checkout extension.
What is GraphQL?
GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.
Index
Requirements
To use the plugin you must use:
- Buckaroo Magento 2 Payment module 1.52.1 or higher.
Installation
- Install the module composer by running the following command:
composer require buckaroo/magento2graphql
- Enable the module by running the following command:
php bin/magento module:enable Buckaroo_Magento2Graphql
- Apply database updates by running the following command:
php bin/magento setup:upgrade
- Flush the cache by running the following command:
php bin/magento cache:flush
Usage
Example requests
- Get the available payments 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 in order for the payment engine to redirect back to your application after the payment was completed/canceled/failed - Finally execute the the default
placeOrder
that will return a redirect url for the payment engine to complete the payment
- Set the payment method on the cart with the required additional parameters using the default
For iDEAL we have the following example (Note: iDEAL no longer requires issuer selection - bank selection happens on the redirect page):
mutation doBuckarooPayment( $cartId: String! $returnUrl: String! $methodCode: String! ) { setPaymentMethodOnCart( input: { cart_id: $cartId payment_method: { code: $methodCode buckaroo_additional: { buckaroo_magento2_ideal: {} } } } ) { 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 migration is performed you will need to store the buckaroo transaction_id
and redirect the user to complete the payment
Retrieve the payment status
Retrieve Payment Status
After the user completes payment and is redirected back, use the buckarooPaymentTransactionStatus
query with the stored transaction_id
:
Option 1: Inline syntax (simple)
mutation { buckarooPaymentTransactionStatus(input: { transaction_id: "E397CF4C24E64AA299F45246F9906F45" }) { payment_status status_code } }
Option 2: With variables (recommended for dynamic values)
mutation checkPaymentStatus($input: BuckarooPaymentTransactionStatusInput!) { buckarooPaymentTransactionStatus(input: $input) { payment_status status_code } }
Variables:
{ "input": { "transaction_id": "E397CF4C24E64AA299F45246F9906F45" } }
SEPA Direct Debit Example
For SEPA Direct Debit payments, use the following format:
mutation doSepaPayment($cartId: String!, $returnUrl: String!) { setPaymentMethodOnCart( input: { cart_id: $cartId payment_method: { code: "buckaroo_magento2_sepadirectdebit" buckaroo_additional: { buckaroo_magento2_sepadirectdebit: { customer_iban: "NL13TEST0123456789" customer_bic: "TESTNL2A" customer_account_name: "Test Account Holder" } } } } ) { cart { selected_payment_method { code } } } setBuckarooReturnUrl(input: { return_url: $returnUrl, cart_id: $cartId }) { success } placeOrder(input: { cart_id: $cartId }) { order { order_number buckaroo_additional { transaction_id } } } }
Additional information
- Support: https://support.buckaroo.eu/contact
- Contact: support@buckaroo.nl or +31 (0)30 711 50 50
Contribute
We really appreciate it when developers contribute to improve the Buckaroo plugins. If you want to contribute as well, then please follow our Contribution Guidelines.
Community is the 💚 of open source
Developing beautiful products is not possible without the input of a community. We thank everyone who actively contributes to this.
Versioning
Please note:
This file has been prepared with the greatest possible care and is subject to language and/or spelling errors.