CAPI - PT2U

This document guides the developer on how to use CAPI services to purchase a PT2U. ​ The reader is advised to familiarise himself/herself with the PT2U process by reading CReME™-PT2U before this. This process consists of the following processes:

1. Select a Trainer Package
2. Input Delivery Address
3. Verify Computed Delivery Address
4. Proceed to Checkout

The user is also assumed to be familiar with CAPI - Introduction.

To display the Personal Trainer list, the following request is submitted:

• Request URI: https://capi.bizt.my:8888/v1/PT2U/ListOfTrainers
• Body: ChannelKey:CEV75FGS6TA2VMYHF6G9MKV7 (there is no ";" at the end of the request)
• Response:

The response consists of an array of trainers. In the above example, there are 3 Personal Trainers listed. Each Personal Trainer has the following attributes:

• PersonId: the unique identifer of the Personal Trainer
• ImageBase64: this is a very long string of characters. In the example above, it has been truncated (shortened) showing only the beginning and end of the string.
• Fullname: Trainer's name
• Description: Description of the trainer
• Packages: an array of Packages with each package haveing 3 attributes:
  1. Title
  2. Price
  3. PackagePersonalTrainerId

There are two types of Delivery Address: DeliveryAddressInputted> and DeliveryAddressComputed>. After the user inputs the Delivery Address, CReME calculates the distance between that address and the home club of the member.

• Request URI: https://capi.bizt.my:8888/v1/PT2U/GetComputedAddress
• Body: ChannelKey:CEV75FGS6TA2VMYHF6G9MKV7;OtherEmailAddress:member1@bizt.my;DeliveryAddressInputted:Paradigm Mall Kelana Jaya (there is no ";" at the end of the request)
• Response:

The response consists of the following attributes:

• Status: should be "OK". If not, the user should be asked to re-input the DeliveryAddressInputted
• AddressOrigin: the address of the home club of OtherEmailAddress
• AddressDestination: the DeliveryAddressComputed which is how CReME has interpreted the DeliveryAddressInputted. It is important for the user to verify that CReME has understood the DeliveryAddressInputted correctly by checking that the DeliveryAddressComputed is correct.
• DistanceInKmTo: distance from the home club to the DeliveryAddressComputed
• DistanceInKmFrom: distance of the return trip
• TravelDurationInMinutesTo: estimated travelling time from the home club to the DeliveryAddressComputed
• estimated travalling time for the return trip

If the status of the response is "OK", the user can proceed to Checkout. Checkout can be initiated by issuing the following request:

• Request URI: https://capi.bizt.my:8888/v1/PT2U/Checkout
• Body: ChannelKey:CEV75FGS6TA2VMYHF6G9MKV7;SessionKey:UFJA86JGNPEVZMJ634BGMSAJ;OtherEmailAddress:member1@bizt.my;PackagePersonalTrainerId:2079361;DeliveryAddressInputted:Paradigm Mall Kelana Jaya;DeliveryAddressComputed:1, Jalan SS 7/26a, Ss 7, 47301 Petaling Jaya, Selangor, Malaysia;DistanceInKmTo:21.429;DistanceInKmFrom:23.333;TravelDurationInMinutesTo:28;TravelDurationInMinutesFrom:26 " (there is no ";" at the end of the request)
• Response:

A successful response contains "DeliveryCharges successfully calculated" as the response. Any other response indicates the request failed. The Payload value is the cost of the Delivery Charges. In this example, it is RM46.00

There are two types of Delivery Address: DeliveryAddressInputted> and DeliveryAddressComputed>. After the user inputs the Delivery Address, CReME calculates the distance between that address and the home club of the member.

After "Delivery Charges successfully calculated", the contents of the Shopping Cart can be read by issuing the following request:

• Request URI: https://capi.bizt.my:8888/v1/ShoppingCart/Read
• Body: ChannelKey:CEV75FGS6TA2VMYHF6G9MKV7;SessionKey:UFJA86JGNPEVZMJ634BGMSAJ;eMailAddress:member1@bizt.my (there is no ";" at the end of the request)
• Response:

The above response consists of the following fields:

For further information on how to process the items in Shopping Cart, please refer to CAPI-Purchase beginning at https://capi.bizt.my:8888/v1/ShoppingCart/SelectedItems/Value.