How CryptoWoo handles mispayments

[av_heading tag=’h1′ padding=’10’ heading=’How CryptoWoo handles mispayments’ color=” style=’blockquote modern-quote modern-centered’ custom_font=” size=” subheading_active=” subheading_size=’15’ custom_class=”][/av_heading]

[av_hr class=’invisible’ height=’50’ shadow=’no-shadow’ position=’center’ custom_border=’av-border-thin’ custom_width=’50px’ custom_border_color=” custom_margin_top=’30px’ custom_margin_bottom=’30px’ icon_select=’yes’ custom_icon_color=” icon=’ue808′ font=’entypo-fontello’ custom_class=”]

[av_textblock size=” font_color=” color=” custom_class=”]
Mispayments, if not handled properly, can create unsatisfying customer experiences and a lot of work for everyone involved. A “Mispayment” occurs when the customer sends a wrong amount of cryptocurrency to pay for an order.

In addition to the direct feedback for the customer on the payment page, CryptoWoo offers several ways to allow merchants to adapt the plugin behavior and provide a smoother shopping experience:
[/av_textblock]

[av_one_full first min_height=” vertical_alignment=” space=” custom_margin=” margin=’0px’ padding=’0px’ border=” border_color=” radius=’0px’ background_color=” src=” background_position=’top left’ background_repeat=’no-repeat’ animation=” mobile_display=”]

[av_image_hotspot src=’https://www.cryptowoo.com/wp-content/uploads/2016/07/advanced-processing-options-1030×797.png’ attachment=’1891′ attachment_size=’large’ animation=’no-animation’ hotspot_layout=’numbered’ hotspot_tooltip_display=” hotspot_mobile=’aviaTBhotspot_mobile’ custom_class=”]
[av_image_spot tooltip_pos=’av-tt-pos-right av-tt-align-centered’ tooltip_width=’av-tt-xlarge-width’ tooltip_style=’main_color’ link=” link_target=” hotspot_color=” custom_bg=” custom_font=” custom_pulse=” hotspot_pos=’42.4,60.2′]
“Payment incomplete” notice threshold (%)

If a payment from a customer is less than the order amount but above this threshold, the customer will receive an email 5 minutes before the order is cancelled, requesting him to pay the missing amount.
[/av_image_spot]
[av_image_spot tooltip_pos=’av-tt-pos-right av-tt-align-bottom’ tooltip_width=’av-tt-xlarge-width’ tooltip_style=’main_color’ link=” link_target=” hotspot_color=” custom_bg=” custom_font=” custom_pulse=” hotspot_pos=’8.9,59.2′]
“Order Expiration Time”

The duration in minutes after which the order expires and no further payment will be accepted. Your exchange rate volatility risk increases the more time you give your customers to pay for their order. If you set this value very low, your customers will have less time to pay before the order status is set to “cancelled”.
[/av_image_spot]
[av_image_spot tooltip_pos=’av-tt-pos-right av-tt-align-top’ tooltip_width=’av-tt-large-width’ tooltip_style=’main_color’ link=” link_target=” hotspot_color=” custom_bg=” custom_font=” custom_pulse=” hotspot_pos=’64.4,61.7′]
Overpayment Buffer

Percentage of the order amount that has to be exceed before an order is flagged as overpayment .
[/av_image_spot]
[av_image_spot tooltip_pos=’av-tt-pos-right av-tt-align-centered’ tooltip_width=’av-tt-xlarge-width’ tooltip_style=’main_color’ link=” link_target=” hotspot_color=” custom_bg=” custom_font=” custom_pulse=” hotspot_pos=’87.6,62.8′]
Custom Overpayment Message

Customize the message that is sent to the customer if he sent a higher amount than required.

Available placeholders:

• {{PERCENTAGE_PAID}}
• {{AMOUNT_DIFF}}
• {{PAYMENT_CURRENCY}}
• {{REFUND_ADDRESS}} (if entered on checkout page)

[/av_image_spot]
[/av_image_hotspot]

[/av_one_full][av_hr class=’invisible’ height=’50’ shadow=’no-shadow’ position=’center’ custom_border=’av-border-thin’ custom_width=’50px’ custom_border_color=” custom_margin_top=’30px’ custom_margin_bottom=’30px’ icon_select=’yes’ custom_icon_color=” icon=’ue808′ font=’entypo-fontello’ custom_class=”]

[av_section min_height=” min_height_px=’500px’ padding=’default’ shadow=’no-shadow’ bottom_border=’no-border-styling’ id=” color=’alternate_color’ custom_bg=” src=” attachment=” attachment_size=” attach=’scroll’ position=’top left’ repeat=’no-repeat’ video=” video_ratio=’16:9′ overlay_opacity=’0.5′ overlay_color=” overlay_pattern=” overlay_custom_pattern=” custom_class=”]
[av_textblock size=” font_color=” color=” custom_class=’hotspot_a’]

Underpayment

If a payment from a customer is less than the order amount but above the percentage of the order amount specified in the option “‘Payment incomplete’ notice threshold“[1], the customer will receive an email 5 minutes before the order is cancelled, requesting him to pay the missing amount.

The plugin will then wait for another period of time specified in the option “Order Expiration Time”[2], giving the customer a chance to send the missing amount. If the customer fails to send the missing amount within the extended time period, the order status is changed to “on hold” and the order is removed from the background polling queue. Both, the merchant and the customer are then notified via email to manually resolve the situation.
[/av_textblock]
[/av_section]

[av_section min_height=” min_height_px=’500px’ padding=’default’ shadow=’no-shadow’ bottom_border=’no-border-styling’ id=” color=’main_color’ custom_bg=” src=” attachment=” attachment_size=” attach=’scroll’ position=’top left’ repeat=’no-repeat’ video=” video_ratio=’16:9′ overlay_opacity=’0.5′ overlay_color=” overlay_pattern=” overlay_custom_pattern=” custom_class=”]

[av_one_half first min_height=” vertical_alignment=” space=” custom_margin=” margin=’0px’ padding=’0px’ border=” border_color=” radius=’0px’ background_color=” src=” background_position=’top left’ background_repeat=’no-repeat’ animation=” mobile_display=”]

[av_textblock size=” font_color=” color=” custom_class=’hotspot_a’]

Overpayment

Customers may accidentally overpay for their order, whether due to miner fees being added unnecessarily, accidentially using a different exchange ratthe, or due to errant keystrokes. CryptoWoo lets merchants configure an “Overpayment Buffer”[3] that determines the percentage by which a payment must exceed the order amount before the order is considered an overpayment.

In case of an overpayment the order is automatically completed but flagged as overpaid, which triggers an email to the store owner and the customer. The “Overpayment Message Text”[4] email to the customer can be configured by using placeholders for the different variables. This way, the customer will successfully receive their items without merchant intervention and the merchant can easily find all required information to send the excess amount back to the customer.

Quick refunds

If the customer entered a refund address during checkout, the e-mail to the administrator also contains a QR code with a BIP21 compatible URI. This enables merchants to automatically pre-fill the wallet client with the details for the refund transaction by scanning the QR code or clicking the link in the same way as the customer does it on the payment page.
[/av_textblock]

[/av_one_half][av_one_half min_height=” vertical_alignment=” space=” custom_margin=” margin=’0px’ padding=’0px’ border=” border_color=” radius=’0px’ background_color=” src=” background_position=’top left’ background_repeat=’no-repeat’ animation=” mobile_display=”]

[av_gallery ids=’1926,1924′ style=’thumbnails’ preview_size=’portfolio’ crop_big_preview_thumbnail=’avia-gallery-big-crop-thumb’ thumb_size=’portfolio’ columns=’2′ imagelink=’lightbox’ lazyload=’avia_lazyload’ custom_class=”]

[/av_one_half][/av_section][av_section min_height=” min_height_px=’500px’ padding=’default’ shadow=’no-shadow’ bottom_border=’no-border-styling’ id=” color=’alternate_color’ custom_bg=” src=” attachment=” attachment_size=” attach=’scroll’ position=’top left’ repeat=’no-repeat’ video=” video_ratio=’16:9′ overlay_opacity=’0.5′ overlay_color=” overlay_pattern=” overlay_custom_pattern=” custom_class=”]
[av_three_fifth first min_height=” vertical_alignment=” space=” custom_margin=” margin=’0px’ padding=’0px’ border=” border_color=” radius=’0px’ background_color=” src=” background_position=’top left’ background_repeat=’no-repeat’ animation=” mobile_display=”]

[av_textblock size=” font_color=” color=” custom_class=”]

Refund Address

In order to streamline cases in which a merchant may need to refund a customer, CryptoWoo allows the collection of refund addresses on the checkout page.

The refund address is saved in the meta data of each WooCommerce order. It can be viewed on the “Order Edit” page and will be displayed in the overpayment notification that is sent to the shop administrator. Additionally, merchants can use the placeholder {{REFUND_ADDRESS}} to include the refund address in the overpayment message that is sent to the customer.
[/av_textblock]

[av_hr class=’invisible’ height=’20’ shadow=’no-shadow’ position=’center’ custom_border=’av-border-thin’ custom_width=’50px’ custom_border_color=” custom_margin_top=’30px’ custom_margin_bottom=’30px’ icon_select=’yes’ custom_icon_color=” icon=’ue808′ font=’entypo-fontello’ custom_class=”]

[av_image src=’https://www.cryptowoo.com/wp-content/uploads/2016/07/refund-address-custom-field.png’ attachment=’1929′ attachment_size=’full’ align=’center’ styling=” hover=’av-hover-grow’ link=’lightbox’ target=” caption=” font_size=” appearance=” overlay_opacity=’0.4′ overlay_color=’#000000′ overlay_text_color=’#ffffff’ animation=’no-animation’ custom_class=”][/av_image]

[av_hr class=’invisible’ height=’15’ shadow=’no-shadow’ position=’center’ custom_border=’av-border-thin’ custom_width=’50px’ custom_border_color=” custom_margin_top=’30px’ custom_margin_bottom=’30px’ icon_select=’yes’ custom_icon_color=” icon=’ue808′ font=’entypo-fontello’ custom_class=”]

[av_heading tag=’h3′ padding=’10’ heading=’How to retrieve the refund address from the WooCommerce order meta’ color=” style=’blockquote modern-quote’ custom_font=” size=’20’ subheading_active=” subheading_size=’15’ custom_class=”][/av_heading]

[av_codeblock wrapper_element=’pre’ wrapper_element_attributes=” custom_class=”]
// Get the refund address for this order
$refund_address = get_post_meta($order_id, ‘refund_address’, true);
[/av_codeblock]

[/av_three_fifth][av_two_fifth min_height=” vertical_alignment=” space=” custom_margin=” margin=’0px’ padding=’0px’ border=” border_color=” radius=’0px’ background_color=” src=” background_position=’top left’ background_repeat=’no-repeat’ animation=” mobile_display=”]

[av_image src=’https://www.cryptowoo.com/wp-content/uploads/2014/11/cryptowoo-checkout-page.png’ attachment=’1721′ attachment_size=’full’ align=’center’ styling=” hover=” link=’lightbox’ target=” caption=” font_size=” appearance=” overlay_opacity=’0.4′ overlay_color=’#000000′ overlay_text_color=’#ffffff’ animation=’no-animation’ custom_class=”][/av_image]

[/av_two_fifth]
[/av_section]

[av_section min_height=” min_height_px=’500px’ padding=’default’ shadow=’no-shadow’ bottom_border=’no-border-styling’ id=” color=’main_color’ custom_bg=” src=” attachment=” attachment_size=” attach=’scroll’ position=’top left’ repeat=’no-repeat’ video=” video_ratio=’16:9′ overlay_opacity=’0.5′ overlay_color=” overlay_pattern=” overlay_custom_pattern=” custom_class=”]
[av_one_fourth first min_height=” vertical_alignment=” space=” custom_margin=” margin=’0px’ padding=’0px’ border=” border_color=” radius=’0px’ background_color=” src=” background_position=’top left’ background_repeat=’no-repeat’ animation=” mobile_display=”]

[av_textblock size=” font_color=” color=” custom_class=”]

Programmatically handle mispayments

Programmers can use the action hook “cryptowoo_refund_required” to execute custom code in case of a mispayment. The variable $order_data contains all required information about the order.
[/av_textblock]

[/av_one_fourth][av_three_fourth min_height=” vertical_alignment=” space=” custom_margin=” margin=’0px’ padding=’0px’ border=” border_color=” radius=’0px’ background_color=” src=” background_position=’top left’ background_repeat=’no-repeat’ animation=” mobile_display=”]

[av_codeblock wrapper_element=’pre’ wrapper_element_attributes=” custom_class=”]
// Hook in
add_action(‘cryptowoo_refund_required’, ‘my_custom_refund_notifier’)

// Run function
function my_custom_refund_notifier($order_data) {

// Get the refund address for this order
$refund_address = get_post_meta($order_data->order_id, ‘refund_address’, true);

// Access the order data
$order_amount = $order_data->crypto_amount; // Order amount in satoshi
$amount_to_refund = $order_data->amount_diff; // Difference to order amount in satoshi
$percentage_paid = $order_data->percentage_paid; // Received amount as percentage of order total

// Do something

}
[/av_codeblock]

[/av_three_fourth]
[/av_section]

[av_button_big label=’Contact us’ description_pos=’above’ link=’page,92′ link_target=” icon_select=’yes-left-icon’ icon_hover=’aviaTBicon_hover’ icon=’ue805′ font=’entypo-fontello’ custom_font=’#ffffff’ color=’theme-color’ custom_bg=’#444444′ color_hover=’theme-color’ custom_bg_hover=’#444444′ custom_class=”]
Do you have a question or want to provide feedback? Contact us and we will get back to you soon!
[/av_button_big]

[av_heading tag=’h3′ padding=’10’ heading=’Related Entries’ color=” style=’blockquote modern-quote’ custom_font=” size=” subheading_active=” subheading_size=’15’ custom_class=”][/av_heading]

[av_hr class=’default’ height=’50’ shadow=’no-shadow’ position=’center’ custom_border=’av-border-thin’ custom_width=’50px’ custom_border_color=” custom_margin_top=’30px’ custom_margin_bottom=’30px’ icon_select=’yes’ custom_icon_color=” icon=’ue808′]

[av_blog blog_type=’posts’ categories=’19’ link=’category’ blog_style=’blog-grid’ columns=’3′ contents=’excerpt’ content_length=’content’ preview_mode=’auto’ image_size=’portfolio’ items=’3′ offset=’0′ paginate=’no’ conditional=” custom_class=”]