Webhooks are automated data sent from GRWV.APP to a URL set by you when something happens. Use the webhook to validate and finalize the purchase. For security reasons you should always validate the purchase via webhook. You must be a developer and know how to coding to setup the webhook.

How to validate a purchase

• In Settings > Webhook > Webhook URL enter the destination URL. GreenWAVES will send the data to this URL. The URL must point to a file that read the data received, with PHP, you can use the code below to read the data.

  $response = json_decode(file_get_contents('php://input'), true);

• In Settings > Webhook > Webhook secret key enter a secret password of your choice. The password will be included in all webhook calls (see key value in the example below). Use it to verify that the webhook is sent by GreenWAVES and not someone else.
• Save the changes. GreenWAVES will now start sending the below data when a payment is complete. To validate the transaction you must check that the value of the key status is equal to C. If the transaction was made from a dynamic checkout, you must also verify that the transaction amount_fiat value is correct and eqaual to the price amount of the purchased item.

  {
      "key": "123456789",
      "transaction": {
          "id": "231",
          "title": "My checkout title",
          "description": "My checkout description",
          "from": "0x078303fEf888Eadd849312d8b73ca82933e5d00A",
          "to": "0x078303fEf888Eadd849312d8b73ca82933e5d00A",
          "hash": "0x219c676e0731892a1f7ef635b2945269c2d9b53d7c36cc331da1bb4e1e526c46",
          "amount": "0.001",
          "amount_fiat": "0.1",
          "cryptocurrency": "grwv",
          "currency": "eur",
          "external_reference": "",
          "creation_time": "2024-04-30 10:00:00",
          "status": "C",
          "webhook": "1"
          "vat": {"amount":"0.33","percentage":"22","country":"Germany","country_code":"DE"}
      }
  }
  

Information

• The webhook sent when a payment is confirmed is only ever sent 1 time.

Dynamic checkouts

To create checkouts by HTML code place the code below into the web page where you want to show the checkout. Copy the Embed code from the checkouts page.

<div data-bxc="name" data-price=""></div>

WordPress shortcode

If you are using the WordPress version you can also use the following shortcode.

[greenwaves id="custom-123" price="" description="" type="inline"]

Attributes

If you are using the WordPress shortcode or the URL method remove the prefix data- from all attributes.

data-grwv

data-price

data-external-reference

data-redirect

data-currency

data-type

data-note

data-pay

Warning Security measure

When using dynamic checkouts without encrypting attributes you must validate the payment via webhook and verify that the transaction amount_fiat value is correct and eqaual to the price amount of the purchased item.

Custom tokens

You can submit your ERC-20 and BEP-20 tokens and start accepting payments with them.

Unlisted token

If your token is not listed on major cryptocurrency exchanges, GreenWAVES cannot get your token's FIAT exchange rate easily. To solve this we can offer support and list your currency even if it is not supported by major exchanges. This service will cost to implement, and is subject to a range of 0$-200$. To list your token please contact us at info@grwv.app or through Telegram

Listed token

If your token is listed on major cryptocurrency exchanges, please provide us with informations at info@grwv.app or through Telegram

PayPal

Use PayPal to start accepting payments via PayPal. To get started, follow the steps below.

• Enter the PayPal email of the account that will receive the payments in GRWV.APP > Settings > PayPal > PayPal email.
• From the top right profile menu click Account Settings > Website payments > Website preferences (https://www.paypal.com/businessmanage/preferences/website) and set the Auto return for website payments to on. Enter http://# as URL.

Information

• You can create a sanbox account to make test payments at https://www.sandbox.paypal.com. To make a payment use a sandbox account from https://developer.paypal.com/dashboard/accounts.
• The details of the PayPal user who sent the payment are visible in the details of the GreenWAVES transaction.

Stripe

Use Stripe to start accepting credit or debit card payments. To get started using Stripe, follow the steps below.

• Register a Stripe account at https://dashboard.stripe.com/register.
• Activate your account at https://dashboard.stripe.com/account/onboarding.
• Visit https://dashboard.stripe.com/webhooks and add an end point, in Endpoint URL enter https://grwv.app/stripe.php Listen for the following events: checkout.session.completed.
• Create a new product from https://dashboard.stripe.com/products and copy the Product ID, e.g. prod_MAxqp5jYGKu2Sx, paste it in GRWV.APP > Settings > Stripe > Product ID. With GreenWAVES, a single product is utilized for all your sales, automatically applying the appropriate sale price. The product title should be generic, such as "Crypto Payment".
• Get the secret key from https://dashboard.stripe.com/apikeys.
• Mind that the amount must be greater than 1 USD ot Stripe may not work.
• Mind that in localhost the transaction will not be marked as completed because the Stripe webhook can not be received.

Information

• Activate Stripe Tax if you are using the Stripe Tax service.

Verifone

Use Verifone (formerly 2Checkout) to start accepting credit or debit card payments. To get started using Verifone, follow the steps below.

• Register a Verifone account at https://www.2checkout.com. You can choose the plan you prefer.
• Go to https://secure.2checkout.com/cpanel/webhooks_api.php (Dashboard > Integrations > Webhooks & API) and copy Merchant Code, Secret Key, and Buy link secret word, paste the values in GreenWAVES > Settings > 2Checkout.
• Go to https://secure.2checkout.com/cpanel/webhooks_api.php (Dashboard > Integrations > Webhooks & API > IPN Settings) and add a new IPN URLs, enter the URL https://grwv.app/verifone.php In General IPN Settings select the trigger Authorized and approved orders (sent after electronic delivery) and save the changes.
• You will need to activate and verify your account before starting selling to real customers but you can use the payment details of the following page for testing purposes: https://verifone.cloud/docs/2checkout/Documentation/09Test_ordering_system/01Test_payment_methods.
• Mind that in localhost the transaction will not be marked as completed because the Verifone webhook can not be received.

Invoicing

• Invoices are not available for pending transactions.
• Invoices are deleted after 24 hours for security reasons. Administrators and users can re-generate them at a later time.
• The invoice generation link is admin.grwv.app/pay.php?invoice=ENCRYPTED-TRANSACTION-ID for example: admin.grwv.app/pay.php?invoice=8kjY56imsLMd89oklbv4. Add the URL attribute download to show directly the PDF.

VAT

• If you enable VAT validation you need to create an account at https://vatsense.com and enter the API key in Settings > VAT > Vatsense API key. This is a paid service but you have 100 free validations per month.
• Once checked, all VAT numbers, even the invalid ones, are saved in the GreenWAVES database and excluded from any future verification.
• To deduct the VAT amount for valid VAT numbers, it is necessary to enable VAT validation.
• VAT is automatically calculated based on the user's IP address.
• VAT is only shown if the IP address is from a VAT-applying country.
• If VAT is enabled, your webhook must verify that the value is equal to or greater than the original value.
• If the invoice is enabled and the user changes the country of the invoice, the VAT country changes accordingly.
• The VAT amount is shown on the PDF invoice.
• The VAT rates are provided by https://vatstack.com and are updated periodically.
• VAT details are sent in the webhook and in the TransactionCompleted JavaScript event.
• VAT details are visible in the transaction details.
• VAT does not need to be enabled for WooCommerce purchases because it is handled by WooCommerce.

Information

• Pending transactions older than 48 hours are deleted automatically. You can change the interval from Settings > Exchange rates refresh interval. Once a pending transaction is deleted, the receiving address linked to it will be available again.
• To disable a cryptocrrency from the payment options remove the cryptocrrency address.
• Multiple checkouts can be present in the same web page but only one will be active at same time.
• GreenWAVES will query the blockchain via AJAX every 5 seconds to verify the payment of pending transactions.
• To test a completed transction multiple times without a real payment add the following attributes to the checkout URL: ?demo=true&amount=[123]&id=[ID]&webhook_key=[key]. Replace [123] with the exact transaction cryptocurrency amount, [ID] with the GreenWAVES transaction ID, [key] with the GreenWAVES webhook secret key, this attribute is optional. The blockchain transaction time must be higher than the GreenWAVES transaction time. If you are using the WordPress version, you have to set the webhook secret key.

Credits

GreenWAVES is powered by the free service below. We thank all the services below for offering free and professional services to the crypto community.

• https://mempool.space/
• https://nownodes.io/
• https://blockstream.info/
• https://blockdaemon.com/
• https://blockcypher.com/
• https://etherscan.io/
• https://ethplorer.io/
• https://bscscan.com/

WordPress

Download and Install the Wordpress plugin of GRWV.APP

• The Wordpress Plugin for GreenWAVES Payments is available here.
• After installation please connect the Webhooks and your User ID correctly.
• Insert the shortcode from the GRWV.APP checkout page to your wordpress site to accept payments.

WooCommerce

To start accepting cryptocurrency payments in your WooCommerce shop, follow the steps below.

Downlaod the GRWV.APP Plugin

• Download the GRWV.APP WordPress Plugin from here. Upload the Plugin and install, and activate it, and enter the Settings Wordpress > Settings > greenwaves.
• If you haven't already, create an account to GRWV.APP here. Head to the Settings menu and Setup your account by providing your wallet address for each currency you wish to accept. GRWV.APP > Settings >. Go to the Wordpress > Settings > greenwaves and copy the Webhook URL into the GRWV.APP Webhook URL at the settings page, also enter a Webhook KEY which can be anything, and acts as a password of your webhook URL.
• From the WordPress administration area go WooCommerce > Settings > Payments activate the GreenWAVES payment gateway.

Information

• If you encounter problems, Check the option Do not finalize order to prevent a WooCommerce order from being finalized upon payment completion

Shopify

To start accepting cryptocurrency payments in your Shopify store, follow the steps below.

• Open your store settings area and click Apps and sales channels, then click App Development and Allow custom app development.
• Click Create an app, enter the app name you want, and create the app.
• Click Configure Admin API scopes and select the following: write_assigned_fulfillment_orders, read_assigned_fulfillment_orders, write_orders, read_orders
• Click SAVE then open the API credentials tab and click Install app, after the installation copy the API access token and paste it into GRWV.APP > Settings > Shopify > Access token.
• Copy and paste your store URL to GRWV.APP > Settings > Shopify > Store URL , e.g. https://greenwaves.myshopify.com.
• Open again your Shopify store settings area and click Checkout and accounts, insert the following code into the Order status page field:

  <script>
  	if (!window.location.search.includes("cryptocurrency")) {
  		let GRWV_URL = "https://admin.grwv.app";
  		let GRWV_API = "GRWV_API_KEY";
  		let GRWV_PAYMENT_METHOD_TEXT = ["Pay with Crypto"];
  		let GRWV_INTERVAL = setInterval(function () {
  			let element = document.getElementsByClassName("payment-method-list__item__info");
  			if (element.length) {
  				if (GRWV_PAYMENT_METHOD_TEXT.includes(element[0].innerHTML)) {
  					document.location = GRWV_URL + "/pay.php?checkout_id=custom-shopify&price=" + Shopify.checkout.payment_due + "&currency=" + Shopify.checkout.currency + "&external-reference=shopify_" + Shopify.checkout.order_id + "&redirect=" + encodeURIComponent(document.location.href) + "&note=Shopify Order ID " + Shopify.checkout.order_id + "&cloud=" + GRWV_API;
  				}
  				clearInterval(GRWV_INTERVAL);
  			}
  		}, 50);
  	}
  </script>
  

  Replace GRWV_API_KEY with your GRWV.App API key which you can find at the GRWV.APP > Accounts > API Key
• Open again your store settings area and click Payments, then click Add manual payment method and Create custom payment method. As Custom payment method name enter Pay with Crypto. You can change "Pay with Crypto" with something else but in such a case you have to replace it also on the code of the previous point. If you add translatons you have to add them in the code of the previous point, e.g. let GRWV_PAYMENT_METHOD_TEXT = ["Pay with Crypto", "Pagar con Cripto", "ادفع باستخدام Crypto"];.