Typescript SDK for Composable Commerce Checkout APIs.

Usage examples

$3

``html


`

`html

`

$3

`bash
npm install --save @commercetools/ts-client
npm install --save @commercetools/checkout-sdk
`

`ts
const {
ClientBuilder,
createAuthForClientCredentialsFlow,
createHttpClient,
} = require('@commercetools/ts-client')
const { createApiBuilderFromCtpClient } = require('@commercetools/checkout-sdk')

const projectKey = 'mc-project-key'
const authMiddlewareOptions = {
host: 'https://auth.europe-west1.gcp.commercetools.com',
projectKey,
credentials: {
clientId: 'mc-client-id',
clientSecret: 'mc-client-secrets',
},
oauthUri: '/oauth/token', // - optional: custom oauthUri
scopes: [manage_project:${projectKey}],
fetch,
}

const httpMiddlewareOptions = {
host: 'https://checkout.europe-west1.gcp.commercetools.com',
fetch,
}

const client = new ClientBuilder()
.withProjectKey(projectKey)
.withMiddleware(createAuthForClientCredentialsFlow(authMiddlewareOptions))
.withMiddleware(createHttpClient(httpMiddlewareOptions))
.withUserAgentMiddleware()
.build()

// or
const client = new ClientBuilder()
.withProjectKey(projectKey)
.withClientCredentialsFlow(authMiddlewareOptions)
.withHttpMiddleware(httpMiddlewareOptions)
.withUserAgentMiddleware()
.build()

const apiRoot = createApiBuilderFromCtpClient(client)

// calling the checkout-sdk functions
// create a new transaction using the checkout sdk
apiRoot
.withProjectKey({ projectKey })
.transactions()
.post({
body: {
application: {
typeId: 'application',
key: 'checkout-application-key',
},
transactionItems: [
{
paymentIntegration: {
typeId: 'payment-integration',
id: 'payment-integration-id',
},
amount: {
centAmount: 1000,
currencyCode: 'EUR',
},
},
],
cart: {
typeId: 'cart',
id: 'cart-id',
},
},
})
.execute()
.then(...)
.catch(...)

-----------------------------------------------------------------------
// The ts-client also has support for the old syntax
import {
createClient,
createHttpClient,
createAuthForClientCredentialsFlow,
} from '@commercetools/ts-client'
import { createApiBuilderFromCtpClient } from '@commercetools/checkout-sdk'

const projectKey = 'some_project_key'

const authMiddleware = createAuthForClientCredentialsFlow({
host: 'https://auth.europe-west1.gcp.commercetools.com',
projectKey,
credentials: {
clientId: 'some_id',
clientSecret: 'some_secret',
},
httpClient: fetch,
})

const httpMiddleware = createHttpClient({
host: 'https://checkout.europe-west1.gcp.commercetools.com',
httpClient: fetch,
})

const ctpClient = createClient({
middlewares: [authMiddleware, httpMiddleware],
})

const apiRoot = createApiBuilderFromCtpClient(ctpClient)

apiRoot
.withProjectKey({ projectKey })
.transactions()
.post({
body: {
application: {
typeId: 'application',
key: 'checkout-application-key',
},
transactionItems: [
{
paymentIntegration: {
typeId: 'payment-integration',
id: 'payment-integration-id',
},
amount: {
centAmount: 1000,
currencyCode: 'EUR',
},
},
],
cart: {
typeId: 'cart',
id: 'cart-id',
},
},
})
.execute()
.then(...)
.catch(...)
``