Xbase++
Xbase++
Amazon Pay - Get Checkout Session
See more Amazon Pay Examples
Get Checkout Session details includes buyer info, payment instrument details, and shipping address.Chilkat Xbase++ Downloads
LOCAL nSuccess
LOCAL oHttp
LOCAL oPrivKey
LOCAL cPublicKeyId
LOCAL nRespStatusCode
LOCAL oSbResponseBody
LOCAL oJResp
LOCAL cPaymentDescriptor
LOCAL cConstraintId
LOCAL cDescription
LOCAL cStrVal
LOCAL cCheckoutSessionId
LOCAL cWebCheckoutDetailsCheckoutReviewReturnUrl
LOCAL cWebCheckoutDetailsCheckoutResultReturnUrl
LOCAL cWebCheckoutDetailsCheckoutCancelUrl
LOCAL cWebCheckoutDetailsAmazonPayRedirectUrl
LOCAL cChargePermissionType
LOCAL cRecurringMetadataFrequencyUnit
LOCAL cRecurringMetadataFrequencyValue
LOCAL cRecurringMetadataAmountAmount
LOCAL cRecurringMetadataAmountCurrencyCode
LOCAL cProductType
LOCAL cPaymentDetailsPaymentIntent
LOCAL nPaymentDetailsCanHandlePendingAuthorization
LOCAL cPaymentDetailsChargeAmount
LOCAL cPaymentDetailsTotalOrderAmount
LOCAL cPaymentDetailsSoftDescriptor
LOCAL cPaymentDetailsPresentmentCurrency
LOCAL cPaymentDetailsAllowOvercharge
LOCAL cPaymentDetailsExtendExpiration
LOCAL cMerchantMetadataMerchantReferenceId
LOCAL cMerchantMetadataMerchantStoreName
LOCAL cMerchantMetadataNoteToBuyer
LOCAL cMerchantMetadataCustomInformation
LOCAL cSupplementaryData
LOCAL cBuyerBuyerId
LOCAL cBuyerName
LOCAL cBuyerEmail
LOCAL cBuyerPhoneNumber
LOCAL cBuyerPrimeMembershipTypes
LOCAL cBillingAddressName
LOCAL cBillingAddressAddressLine1
LOCAL cBillingAddressAddressLine2
LOCAL cBillingAddressAddressLine3
LOCAL cBillingAddressCity
LOCAL cBillingAddressCounty
LOCAL cBillingAddressDistrict
LOCAL cBillingAddressStateOrRegion
LOCAL cBillingAddressPostalCode
LOCAL cBillingAddressCountryCode
LOCAL cStatusDetailsState
LOCAL cStatusDetailsReasonCode
LOCAL cStatusDetailsReasonDescription
LOCAL cStatusDetailsLastUpdatedTimestamp
LOCAL cShippingAddressName
LOCAL cShippingAddressAddressLine1
LOCAL cShippingAddressAddressLine2
LOCAL cShippingAddressAddressLine3
LOCAL cShippingAddressCity
LOCAL cShippingAddressCounty
LOCAL cShippingAddressDistrict
LOCAL cShippingAddressStateOrRegion
LOCAL cShippingAddressPostalCode
LOCAL cShippingAddressCountryCode
LOCAL cShippingAddressPhoneNumber
LOCAL cPlatformId
LOCAL cChargePermissionId
LOCAL cChargeId
LOCAL cCreationTimestamp
LOCAL cExpirationTimestamp
LOCAL cStoreId
LOCAL cDeliverySpecificationsAddressRestrictionsType
LOCAL cProviderMetadataProviderReferenceId
LOCAL cReleaseEnvironment
LOCAL i
LOCAL nCount_i
nSuccess := 0
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
oHttp := CreateObject("Chilkat.Http")
// Implements the following CURL command:
// curl "https://pay-api.amazon.com/:version/checkoutSessions/:checkoutSessionId"
// -X GET
// -H "authorization:Px2e5oHhQZ88vVhc0DO%2FsShHj8MDDg%3DEXAMPLESIGNATURE"
// -H "x-amz-pay-date:20201012T235046Z"
// Use the following online tool to generate HTTP code from a CURL command
// Convert a cURL Command to HTTP Source Code
// Load your Amazon Pay private key.
// There are many other ways to load private keys into the Chilkat private key object, such as from different formats,
// or from in-memory strings or bytes.
oPrivKey := CreateObject("Chilkat.PrivateKey")
nSuccess := oPrivKey:LoadPemFile("C:/someDir/myAmazonPayPrivateKey.pem")
IF (nSuccess == 0)
? oPrivKey:LastErrorText
oHttp:destroy()
oPrivKey:destroy()
RETURN
ENDIF
// Provide your Amazon Pay private key and Public Key ID
// Use your public key ID here. It must be the one associated with the private key.
// Note: The SetAuthPrivateKey method was added in Chilkat v9.5.0.89
cPublicKeyId := "SANDBOX-AHEGSJCM3L2S637RBGABLAFW"
nSuccess := oHttp:SetAuthPrivateKey(cPublicKeyId, oPrivKey)
IF (nSuccess == 0)
? oHttp:LastErrorText
oHttp:destroy()
oPrivKey:destroy()
RETURN
ENDIF
// Note: When the private key is provided as shown above, Chilkat will automatically add the required x-amz-pay-* headers to the HTTP request,
// and will also sign the request. Nothing more is needed.
// Chilkat automatically generates and adds the following headers:
//
// x-amz-pay-date
// x-amz-pay-host
// x-amz-pay-region
// Authorization
oHttp:Accept := "application/json"
nRespStatusCode := 0
oSbResponseBody := CreateObject("Chilkat.StringBuilder")
nSuccess := oHttp:SetUrlVar("sessionId", "62b7d028-6c7c-4a43-b077-3897dff27c5b")
// To use the live system, replace "sandbox" with "live" in the URL passed to QuickGetSb.
// Also, make sure to use the correct region: pay-api.amazon.com, pay-api.amazon.eu, or pay-api.amazon.jp
nSuccess := oHttp:QuickGetSb("https://pay-api.amazon.eu/sandbox/v2/checkoutSessions/{$sessionId}", oSbResponseBody)
IF (nSuccess == 0)
// If the LastStatus is not equal to 0, then we received a response, but it was an error response.
nRespStatusCode := oHttp:LastStatus
IF (nRespStatusCode != 0)
? "Response Status Code = " + Str(nRespStatusCode)
// A sample response body for the case where the session ID does not exist:
// {"reasonCode":"ResourceNotFound","message":"Resource you are trying to access is not available. Requested path '/sandbox/v2/checkoutSessions/bd504926-f659-4ad7-a1a9-9a747aaf5275'"}
? "Response body:"
? oHttp:LastResponseBody
ELSE
? oHttp:LastErrorText
ENDIF
oHttp:destroy()
oPrivKey:destroy()
oSbResponseBody:destroy()
RETURN
ENDIF
oJResp := CreateObject("Chilkat.JsonObject")
oJResp:LoadSb(oSbResponseBody)
oJResp:EmitCompact := 0
? "Response Body:"
? oJResp:Emit()
nRespStatusCode := oHttp:LastStatus
? "Response Status Code = " + Str(nRespStatusCode)
// We expect a 200 status code for success.
// Note: Some Amazon Pay API calls return 200 for success, others return 201.
IF (nRespStatusCode != 200)
? "Failed."
oHttp:destroy()
oPrivKey:destroy()
oSbResponseBody:destroy()
oJResp:destroy()
RETURN
ENDIF
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "checkoutSessionId": "bd504926-f659-4ad7-a1a9-9a747aaf5275",
// "webCheckoutDetails": {
// "checkoutReviewReturnUrl": "https://a.com/merchant-review-page",
// "checkoutResultReturnUrl": null,
// "checkoutCancelUrl": null,
// "amazonPayRedirectUrl": null
// },
// "chargePermissionType": "Recurring",
// "recurringMetadata": {
// "frequency": {
// "unit": "Month",
// "value": "1"
// },
// "amount": {
// "amount": "30",
// "currencyCode": "USD"
// }
// },
// "productType": "PayAndShip",
// "paymentDetails": {
// "paymentIntent": null,
// "canHandlePendingAuthorization": false,
// "chargeAmount": null,
// "totalOrderAmount": null,
// "softDescriptor": null,
// "presentmentCurrency": null,
// "allowOvercharge": null,
// "extendExpiration": null
// },
// "merchantMetadata": {
// "merchantReferenceId": null,
// "merchantStoreName": null,
// "noteToBuyer": null,
// "customInformation": null
// },
// "supplementaryData": null,
// "buyer": {
// "buyerId": "buyerId",
// "name": "name-1",
// "email": "name@amazon.com",
// "phoneNumber": "800-000-0000",
// "primeMembershipTypes": null
// },
// "billingAddress": {
// "name": "Work",
// "addressLine1": "440 Terry Ave",
// "addressLine2": "",
// "addressLine3": "",
// "city": "Seattle",
// "county": "King",
// "district": "Seattle",
// "stateOrRegion": "WA",
// "postalCode": "98121",
// "countryCode": "US"
// },
// "paymentPreferences": [
// {
// "paymentDescriptor": "Your selected Amazon payment method"
// }
// ],
// "statusDetails": {
// "state": "Open",
// "reasonCode": null,
// "reasonDescription": null,
// "lastUpdatedTimestamp": "20191015T204327Z"
// },
// "shippingAddress": {
// "name": "Susie Smith",
// "addressLine1": "10 Ditka Ave",
// "addressLine2": "Suite 2500",
// "addressLine3": null,
// "city": "Chicago",
// "county": null,
// "district": null,
// "stateOrRegion": "IL",
// "postalCode": "60602",
// "countryCode": "US",
// "phoneNumber": "800-000-0000"
// },
// "platformId": null,
// "chargePermissionId": null,
// "chargeId": null,
// "constraints": [
// {
// "constraintId": "ChargeAmountNotSet",
// "description": "chargeAmount is not set."
// },
// {
// "constraintId": "CheckoutResultReturnUrlNotSet",
// "description": "checkoutResultReturnUrl is not set."
// },
// {
// "constraintId": "PaymentIntentNotSet",
// "description": "paymentIntent is not set."
// }
// ],
// "creationTimestamp": "20191015T204313Z",
// "expirationTimestamp": "20191016T204313Z",
// "storeId": "amzn1.application-oa2-client.8b5e45312b5248b69eeaStoreId",
// "deliverySpecifications": {
// "specialRestrictions": [
// "RestrictPOBoxes"
// ],
// "addressRestrictions": {
// "type": "Allowed",
// "restrictions": {
// "US": {
// "statesOrRegions": [
// "WA"
// ],
// "zipCodes": [
// "95050",
// "93405"
// ]
// },
// "GB": {
// "zipCodes": [
// "72046",
// "72047"
// ]
// },
// "IN": {
// "statesOrRegions": [
// "AP"
// ]
// },
// "JP": {}
// }
// }
// },
// "providerMetadata": {
// "providerReferenceId": null
// },
// "releaseEnvironment": "Sandbox"
// }
// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON
cCheckoutSessionId := oJResp:StringOf("checkoutSessionId")
cWebCheckoutDetailsCheckoutReviewReturnUrl := oJResp:StringOf("webCheckoutDetails.checkoutReviewReturnUrl")
cWebCheckoutDetailsCheckoutResultReturnUrl := oJResp:StringOf("webCheckoutDetails.checkoutResultReturnUrl")
cWebCheckoutDetailsCheckoutCancelUrl := oJResp:StringOf("webCheckoutDetails.checkoutCancelUrl")
cWebCheckoutDetailsAmazonPayRedirectUrl := oJResp:StringOf("webCheckoutDetails.amazonPayRedirectUrl")
cChargePermissionType := oJResp:StringOf("chargePermissionType")
cRecurringMetadataFrequencyUnit := oJResp:StringOf("recurringMetadata.frequency.unit")
cRecurringMetadataFrequencyValue := oJResp:StringOf("recurringMetadata.frequency.value")
cRecurringMetadataAmountAmount := oJResp:StringOf("recurringMetadata.amount.amount")
cRecurringMetadataAmountCurrencyCode := oJResp:StringOf("recurringMetadata.amount.currencyCode")
cProductType := oJResp:StringOf("productType")
cPaymentDetailsPaymentIntent := oJResp:StringOf("paymentDetails.paymentIntent")
nPaymentDetailsCanHandlePendingAuthorization := oJResp:BoolOf("paymentDetails.canHandlePendingAuthorization")
cPaymentDetailsChargeAmount := oJResp:StringOf("paymentDetails.chargeAmount")
cPaymentDetailsTotalOrderAmount := oJResp:StringOf("paymentDetails.totalOrderAmount")
cPaymentDetailsSoftDescriptor := oJResp:StringOf("paymentDetails.softDescriptor")
cPaymentDetailsPresentmentCurrency := oJResp:StringOf("paymentDetails.presentmentCurrency")
cPaymentDetailsAllowOvercharge := oJResp:StringOf("paymentDetails.allowOvercharge")
cPaymentDetailsExtendExpiration := oJResp:StringOf("paymentDetails.extendExpiration")
cMerchantMetadataMerchantReferenceId := oJResp:StringOf("merchantMetadata.merchantReferenceId")
cMerchantMetadataMerchantStoreName := oJResp:StringOf("merchantMetadata.merchantStoreName")
cMerchantMetadataNoteToBuyer := oJResp:StringOf("merchantMetadata.noteToBuyer")
cMerchantMetadataCustomInformation := oJResp:StringOf("merchantMetadata.customInformation")
cSupplementaryData := oJResp:StringOf("supplementaryData")
cBuyerBuyerId := oJResp:StringOf("buyer.buyerId")
cBuyerName := oJResp:StringOf("buyer.name")
cBuyerEmail := oJResp:StringOf("buyer.email")
cBuyerPhoneNumber := oJResp:StringOf("buyer.phoneNumber")
cBuyerPrimeMembershipTypes := oJResp:StringOf("buyer.primeMembershipTypes")
cBillingAddressName := oJResp:StringOf("billingAddress.name")
cBillingAddressAddressLine1 := oJResp:StringOf("billingAddress.addressLine1")
cBillingAddressAddressLine2 := oJResp:StringOf("billingAddress.addressLine2")
cBillingAddressAddressLine3 := oJResp:StringOf("billingAddress.addressLine3")
cBillingAddressCity := oJResp:StringOf("billingAddress.city")
cBillingAddressCounty := oJResp:StringOf("billingAddress.county")
cBillingAddressDistrict := oJResp:StringOf("billingAddress.district")
cBillingAddressStateOrRegion := oJResp:StringOf("billingAddress.stateOrRegion")
cBillingAddressPostalCode := oJResp:StringOf("billingAddress.postalCode")
cBillingAddressCountryCode := oJResp:StringOf("billingAddress.countryCode")
cStatusDetailsState := oJResp:StringOf("statusDetails.state")
cStatusDetailsReasonCode := oJResp:StringOf("statusDetails.reasonCode")
cStatusDetailsReasonDescription := oJResp:StringOf("statusDetails.reasonDescription")
cStatusDetailsLastUpdatedTimestamp := oJResp:StringOf("statusDetails.lastUpdatedTimestamp")
cShippingAddressName := oJResp:StringOf("shippingAddress.name")
cShippingAddressAddressLine1 := oJResp:StringOf("shippingAddress.addressLine1")
cShippingAddressAddressLine2 := oJResp:StringOf("shippingAddress.addressLine2")
cShippingAddressAddressLine3 := oJResp:StringOf("shippingAddress.addressLine3")
cShippingAddressCity := oJResp:StringOf("shippingAddress.city")
cShippingAddressCounty := oJResp:StringOf("shippingAddress.county")
cShippingAddressDistrict := oJResp:StringOf("shippingAddress.district")
cShippingAddressStateOrRegion := oJResp:StringOf("shippingAddress.stateOrRegion")
cShippingAddressPostalCode := oJResp:StringOf("shippingAddress.postalCode")
cShippingAddressCountryCode := oJResp:StringOf("shippingAddress.countryCode")
cShippingAddressPhoneNumber := oJResp:StringOf("shippingAddress.phoneNumber")
cPlatformId := oJResp:StringOf("platformId")
cChargePermissionId := oJResp:StringOf("chargePermissionId")
cChargeId := oJResp:StringOf("chargeId")
cCreationTimestamp := oJResp:StringOf("creationTimestamp")
cExpirationTimestamp := oJResp:StringOf("expirationTimestamp")
cStoreId := oJResp:StringOf("storeId")
cDeliverySpecificationsAddressRestrictionsType := oJResp:StringOf("deliverySpecifications.addressRestrictions.type")
cProviderMetadataProviderReferenceId := oJResp:StringOf("providerMetadata.providerReferenceId")
cReleaseEnvironment := oJResp:StringOf("releaseEnvironment")
i := 0
nCount_i := oJResp:SizeOfArray("paymentPreferences")
DO WHILE i < nCount_i
oJResp:I := i
cPaymentDescriptor := oJResp:StringOf("paymentPreferences[i].paymentDescriptor")
i := i + 1
ENDDO
i := 0
nCount_i := oJResp:SizeOfArray("constraints")
DO WHILE i < nCount_i
oJResp:I := i
cConstraintId := oJResp:StringOf("constraints[i].constraintId")
cDescription := oJResp:StringOf("constraints[i].description")
i := i + 1
ENDDO
i := 0
nCount_i := oJResp:SizeOfArray("deliverySpecifications.specialRestrictions")
DO WHILE i < nCount_i
oJResp:I := i
cStrVal := oJResp:StringOf("deliverySpecifications.specialRestrictions[i]")
i := i + 1
ENDDO
i := 0
nCount_i := oJResp:SizeOfArray("deliverySpecifications.addressRestrictions.restrictions.US.statesOrRegions")
DO WHILE i < nCount_i
oJResp:I := i
cStrVal := oJResp:StringOf("deliverySpecifications.addressRestrictions.restrictions.US.statesOrRegions[i]")
i := i + 1
ENDDO
i := 0
nCount_i := oJResp:SizeOfArray("deliverySpecifications.addressRestrictions.restrictions.US.zipCodes")
DO WHILE i < nCount_i
oJResp:I := i
cStrVal := oJResp:StringOf("deliverySpecifications.addressRestrictions.restrictions.US.zipCodes[i]")
i := i + 1
ENDDO
i := 0
nCount_i := oJResp:SizeOfArray("deliverySpecifications.addressRestrictions.restrictions.GB.zipCodes")
DO WHILE i < nCount_i
oJResp:I := i
cStrVal := oJResp:StringOf("deliverySpecifications.addressRestrictions.restrictions.GB.zipCodes[i]")
i := i + 1
ENDDO
i := 0
nCount_i := oJResp:SizeOfArray("deliverySpecifications.addressRestrictions.restrictions.IN.statesOrRegions")
DO WHILE i < nCount_i
oJResp:I := i
cStrVal := oJResp:StringOf("deliverySpecifications.addressRestrictions.restrictions.IN.statesOrRegions[i]")
i := i + 1
ENDDO
oHttp:destroy()
oPrivKey:destroy()
oSbResponseBody:destroy()
oJResp:destroy()