As part of version 10.5, a new functionality is introduced for mapping custom fields or metadata from Shopify to Payment Item object of Salesforce.
Custom Fields in Payment Item Object
First step is to create custom fields in the Payment Item(AAkPay__Payment_Item__c) object. These fields will store the metadata from shopify.
- Go to Setup → Object Manager.
- Search for Payment Item object.
- Go to Fields and Relationship section and create new fields.
- Field type should be same as the type of metdata coming from shopify (text type of metadata to text field, Date type of metdata field to Date field).
Set Mapping in the Merchant Facility
Now, we need to create a mapping of the metadata from shopify with these new field. For this, a new field Shopify Custom Fields (AAkPay__Shopify_Custom_Fields__c) is introduced in the Merchant Facility object. This is a multiselect picklist field.
- There is a sample picklist value in this multiselect picklist field that explains how the mapping need to be stored as picklist values.
- The format of the mapping is: “Metadata Field Label” + [ “Payment Item custom field API Name” ]
- So the sample added picklist value is "Product SKU[AAkPay__SKU__c]"
The default added picklist value ( Product SKU[AAkPay__SKU__c] ) can be deleted or marked as inactive once you have completed the setup of your own custom mapping.
Example of Mapping
Let's say following custom metadata are coming from shopify webhook:
- _Digital Card Image
- Card Type
- Sending Date
- _Uniqe Line Item Id
- Recipient Email
- Recipient Name
Now, against these metadata information from shopify we can create new custom fields or use existing fields as well for mapping.
Finally, new picklist values are created in the shopify merchant facility field in order to save the mapping.
Make sure to add the picklist values and update the merchanct facility record as well.
