Setting up “Cash on Delivery” payment using SAP Upscale Commerce

Introduction:

Some online merchants wish to provide their customers with a payment method called Cash on Delivery (or COD). Using this method the customer can shop at an online retail store, order a product and then delay the payment for the item until the product is delivered. This blog post outlines how to set up such a payment mechanism with SAP Upscale Commerce.

Prerequisites:

In order to set up CoD you will need the following:

• Administrator access to an SAP Upscale tenant
• Postman installed
• Cash on Delivery postman collection files (environment_configuration.json and mapping_configuration.json) which can be found here.

Overview:

Note that these instructions are for a tenant already configured with another Merchant account (such as Adyen or Stripe).

The general steps for setting up a Cash on Delivery payment are:

• Create your Cash on Delivery Merchant Account in Upscale
• Create an External Application in Upscale to get valid scopes
• Import collections into Postman
• Get Bearer Token
• Set up Postman environment
• Run Postman Collection
• Configure Merchant Account

Step-by-Step Instructions:

In Upscale Workbench:

• Go to Settings –> Payments
• Add a New Merchant Account
• Provide Account name “Cash on Delivery”
• Select Payment integration “Open payment framework – payment method” from dropdown
• Provide Payment method code “cash-on-delivery”
• Make this the default payment gateway
• Add any divisions (if applicable)
• Payment method display name “Cash on Delivery”
• Payment method description “Cash on Delivery”
• Save

Create Merchant Account payment method

• Configure Merchant Account Cash on Delivery
• Enter a dummy Merchant ID 123456
• Save
• Copy and paste the Account ID and Group ID from the URL and save them somewhere safe

Configure your new Merchant Account

• Create an external application in Upscale with accessible scope Payment (read-write), save, then copy the Client ID and Client secret 1 into a safe place.

Create External Application and get Client ID and Secret

In Postman:

• Create a new Workspace
• Go into the Workspace
• Import Postman Collection files and environment file
• Send oath call with client/secret in tenant to get bearer token

Get bearer token

• Edit your environment
• Put in bearer token (in format Bearer xxx)
• Put in root URL to tenant including https, no slash at end
• Put in acccountGroupid (first value from merchant account URL)
• Put in account id (second value from merchant account URL)
• For authorizeAPI, settleApi and refundAPI put in a dummy testing endpoint using a 3rd party tools such as pipedream.

Set up postman environment

• Select Cash on Delivery Config
• Run Cash on Delivery Collection (should get all 200 responses)

Run Postman collection

Back in Upscale:

• Configure Merchant Account
• Select Charge payment per shipment
• Save

Charge card per shipment

• Return to Payment screen
• Click on Alternative payment method tab
• Add a new Alternative payment method
• Give it a APM code cash-on-delivery
• Give it an APM name “Cash on Delivery”
• Choose APM type “Direct” from dropdown
• Settlement Method “Charge card at checkout”
• Merchant account assignment pick Adyen OPF (or default) from dropdown
• Under Consumer facing assets:
• APM display name “Cash on Delivery”
• APM description “Cash on Delivery”
• APM Logo URL if applicable

Alternative Payment Method

Now when checking out you should see an option for Cash on Delivery…

Cash on Delivery available at checkout

Conclusion:

After reading this article you should be familiar with how to set up a “Cash on Delivery” payment in Upscale.

Do you have questions about Setting up Cash on Delivery or SAP Upscale Commerce in general? Do not hesitate to reach out and ask your questions here.

For other Blog Posts on SAP Upscale Commerce, I recommend you to frequently check our Community page and feel free to respond below with any comments or feedback you have on this post!