Skip to main content
POST
cURL
Part of the Subscription Connector integration guide — see it for when and how to use this endpoint.

Headers

Idempotency-Key
string<uuid>
required

Unique identifier for the request; the same value must be sent on retries so the operation is applied at most once.

Body

application/json
subscriptionId
string
required

Unique identifier of subscription in the subscription manager.

Maximum string length: 100
merchantGuid
string<uuid>
required

Global-e merchant unique identifier

currencyCode
string
required

ISO 4217 currency code

Pattern: ^[A-Z]{3}$
products
object[]
required

List of products

Minimum array length: 1
discounts
object[]

Applied discounts for this cycle; not persisted on the subscription.

shippingAmount
number<double>

Shipping amount charged to the shopper for this cycle. 0 means free shipping; omit to let Global-e price it

Required range: x >= 0

Response

Billing summary - selected shipping option and duties and taxes values.

externalReference
string
required

Unique identifier for the request

Maximum string length: 50
dtResults
object[]
required

Array of duty/tax calculation results

selectedShippingOption
object

Shipping option selected for the recurring order (physical / hybrid subscriptions). Not returned for digital-only subscriptions.

fxRates
object[]

Foreign exchange rates used in calculations