Setting up "Cash on Delivery" payment using SAP Up...

former_member772932 · ‎2021 Nov 11

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!