WAON: Overview

This guide is only applicable for organizations that are integrated with WAON Points.

Important Details

1. Users can only register with a +84 country code.
   1. If aeoneshop account does not have a phone number with an +84 country code, they will get an error upon registration.
2. If a customer's phone number is updated in Foxtrot, they will be disconnected from the WAON experience.

Foxtrot

1. View if a user is connected or not connected to WAON on the Client User Page
2. View vouchers applied to an order and any applicable overage on the Order Page → Pricing Details tab → WAON Vouchers table
   1. Overage is the amount of voucher not applied to the order (applicable when order total < voucher value)
3. Use RTUS #22 to scope applicable content or marketing levers to WAON Members
4. Use RTUS #23 to scope applicable content or marketing levers to NON WAON Members

Point Calculations

1. Spresso does not provide point calculations. Spresso submits transaction details to WAON upon order completion with the below information which determines point values.
   1. consumption_amount→ sum of unit selling price* quantity for all items in the order after completed fulfillment.
      1. Selling price is the price after discount from PROFIT in the sales file:
      2. This includes discounts from promotions and price modifiers
      3. This does not include discounts from promo codes, credit or vouchers
      4. This does not include charges from delivery fees
   2. Promo_item1 → UPC
   3. Promo_item2 → SKU code
   4. Promo_item3 → External category ID
   5. stamp → Order Placement Date
   6. delivery_time → Order Settlement Date
   7. System Transfer Date from Spresso to PMS → Order Complete Date

Voucher Refunds

Voucher refunds return the voucher applied on the order back to the customer.

Scenario	Before/After Order Completed	Outcome
Order Cancellation	Before	User will get their applied voucher back to their account.
OOS Scenario causes entire voucher to be unused	Before	User will get their applied voucher back to their account.
OOS Scenario Order total >= voucher value	Before	Entire voucher continues to apply to order.
OOS Scenario Order total < voucher value	Before	Spresso will not refund the voucher overage in any way. AVN to refund WAON Voucher manually.
Partial Refund (Foxtrot Refund)	After	Spresso will not return the refunded voucher to the user. AVN to refund WAON Voucher manually. Spresso system refunds proportionally to the amount paid with each payment method including vouchers. The amount refunded as voucher can be found in the Order Refund History table. The amount of voucher still applied to the order can be found in the B | CRVRTN record in the refund file.
Full Refund (Foxtrot Refund)	After	Spresso will not return the refunded voucher to the user. AVN to refund WAON Voucher manually. Spresso system refunds proportionally to the amount paid with each payment method including vouchers. The amount refunded as voucher can be found in the Order Refund History table. The amount of voucher still applied to the order can be found in the B | CRVRTN record in the refund file. This might happen if there is a delivery fee on the order.

Point Refunds

Point refunds cancel/remove points that were earned from an order.

Scenario	Before/After Order Completed	Outcome
Order Cancellation	Before	Not applicable. Points are only awarded if order is completed.
OOS Scenario	Before	Not applicable. Points are calculated and awarded based on the total when order is completed.
Partial Refund (Foxtrot Refund)	After	Earned points from refunded items will be removed from the user's point balance.
Full Refund (Foxtrot Refund)	After	Earned points from the order will be removed from the user's point balance.

Sales File

Waon Vouchers will be included as B| EVCSLS in the sales file

• Includes full original amount of the voucher
• Value to be positive
• One record for each voucher on the order
• Structure → B | EVCSLS | [voucher value] | [date] [coupon_no] | 0 | 0 | 0 |

Any voucher overage will be offset with B | CRVSLS in the sales file

• Includes amount of voucher not applied to order. Only applicable if order total < voucher total.
• Value to be negative
• One record for each overage on the order
• Structure → B | CRVSLS | [overage] [date] | [coupon_no] | 0 | 0 | 0 |

Refund File

Waon Vouchers will be included as B|EVCRTN in the refund file

• Includes full original amount of the voucher
• Value to be negative
• One record for each voucher on the refund
• Structure → B | EVCRTN | [voucher value] | [date] | [coupon_no]

Any amount of the voucher not applied to the refund (i.e. still applied to the order) will be offset with B | CRVRTN in the refund file

• Includes amount of voucher not applied to refund (i.e still applied to the order). Only applicable if refund total < voucher total.
• Value to be positive
• One record for each overage on the refund
• Structure → B | CRVRTN | [overage] | [date] | [coupon_no]