added
Pre-Launch Announcement: Value Added Service (Signature Delivery and One Time Pass-code) for UK Non-Amazon marketplace volume (OFF-Amazon)
1 day ago
We are excited to announce two new Value Added Services (VAS) for Amazon Shipping API customers: Signature on Delivery (SoD) and OTP On Delivery (OTP). As the e-commerce landscape evolves, we understand the growing need for enhanced delivery security and customer trust, particularly for high-value items. These new features, available exclusively for Amazon Logistics (AMZL) deliveries, provide secure delivery verification methods that ensure packages reach their intended recipients. By implementing these verification solutions, we're helping shippers build stronger trust with their customers while offering peace of mind to both parties throughout the delivery process.
Why is this important?
The Amazon Shipping API enables programmatic access to Amazon Shipping services. With the introduction of new valueAddedServices field supporting "otpOnDelivery" and "signatureOnDelivery", you can now implement secure delivery verification through both getRates and oneClickShipment API flows. These features ensure packages are delivered to verified recipients, reducing delivery risks and enhancing security.
When will this change be launched?
The Value Added Services feature will be available in August 2025 for Off-Amazon Shippers in the UK marketplace only.
Value Added Service details:
With the initial launch, you'll be able to add below value added servces for Amazon Logistics (AMZL) deliveries
- Signature on Delivery (SoD): Request signature verification for your shipments when packages are delivered using Amazon Logistics (AMZL) delivery.
- OTP On Delivery (OTP): Enable OTP verification for secure delivery confirmation, available for AMZL deliveries.
How can I add Value Added Services to my Amazon Shipping deliveries?
- The Value Added Services will be made available via Amazon Shipping V2 API (GetRatesV2 API and oneClickShipment API For Off-Amazon).
- For GetRatesV2 + Purchase flow, simply specify your VAS requirement (signatureOnDelivery or otpOnDelivery) in the GetRatesV2 request. The response will return rates that support your requested VAS, and these VAS requirements will automatically carry through to the purchase step without additional input.
- For oneClickShipment API, you must declare the VAS requirement in your request, and the system will create the shipment with VAS if available with the service selection.
Schema Details:
1- ValueAddedServiceDetails - GetRatesV2 API (Request)
| Name | Description | Schema |
|---|---|---|
| signatureOnDelivery optional | Enable Signature verification for delivery. Not available for access point deliveries. Cannot be combined with otpOnDelivery. | $.valueAddedServices.SignatureOnDelivery |
| otpOnDelivery optional | Enable One Time Pass-code verification for delivery. Requires valid phone number in shipTo address. Not available for access point deliveries or with collectOnDelivery. | $.valueAddedServices.OTPOnDelivery |
2- Rate Item for shipping (base cost, transaction fee, confirmation, insurance, etc.)
| Name | Description | Schema |
|---|---|---|
| rateItemID optional | Unique ID for the rateItem. | RateItemID |
| rateItemType optional | Type of the rateItem. | RateItemType |
| rateItemCharge optional | The monetary value in the currency indicated, in ISO 4217 standard format. | Currency |
| rateItemNameLocalization optional | Used for the localization. | String |
Note: RateItemID will have a new enum added
Type: enum
- SIGNATURE_CONFIRMATION. : Signature confirmation charge
- OTP_ON_DELIVERY_FEE New: One time password fee charge
3- OneClickShipmentResult - OneClickShipment API (Response)
| Name | Description | Schema |
|---|---|---|
| shipmentId required | The unique shipment identifier provided by a shipping service. | ShipmentId |
| packageDocumentDetails required | A list of post-purchase details about a package that will be shipped using a shipping service. | PackageDocumentDetailList |
| promise required | The time windows promised for pickup and delivery events. | Promise |
| carrier required | Carrier Related Info | Carrier |
| service required | Service Related Info | Service |
| totalCharge required | The monetary value in the currency indicated, in ISO 4217 standard format. | Currency |
| rateItemList New optional | A list of RateItem | RateItemList |
How It Works:
1- GetRatesV2 (/shipping/v2/shipments/rates):
{
"shipTo": {
"name": "TEST ",
"addressLine1": "XX XX Road",
"city": "Ashtead",
"stateOrRegion": "Surrey",
"postalCode": "XXXX XXX",
"countryCode": "GB",
"phoneNumber": "44012345678",
"email": "[email protected]"
},
"shipFrom": {
"name": "TEST Seller",
"addressLine1": "XX XXXX",
"city": "Milton Keynes",
"countryCode": "GB",
"postalCode": "XXX XXX",
"email": "[email protected]"
},
"valueAddedServices": { //VAS Element with SoD - Similarly we can use "otpOnDelivery"
"signatureOnDelivery": {
}
},
"packages": [{
"dimensions": {
"length": 10,
"width": 10,
"height": 10,
"unit": "CENTIMETER"
},
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"items": [{
"description": "VAS Test Item",
"itemValue": {
"unit": "GBP",
"value": 10
},
"itemIdentifier": "100100100100",
"quantity": 1,
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"isHazmat": false,
}],
"isHazmat": false,
"insuredValue": {
"unit": "GBP",
"value": 10
},
"packageClientReferenceId": "ORDER123"
}],
"channelDetails": {
"channelType": "EXTERNAL"
}
}
{
"payload": {
"rates": [
{
"benefits": null,
"billedWeight": {
"unit": "KILOGRAM",
"value": 1.0
},
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"creditItemList": null,
"paymentType": null,
"promise": {
"deliveryWindow": {
"end": "2025-06-04T19:00:00Z",
"start": "2025-06-04T19:00:00Z"
},
"pickupWindow": {
"end": "2025-06-02T19:00:00Z",
"start": "2025-06-02T17:30:00Z"
}
},
"rateId": "0435f7f9b784afc1a56ce39e78760ae780c3f9c78fXX02968",
"rateItemList": [
{
"rateItemCharge": {
"unit": "GBP",
"value": 1.7
},
"rateItemID": "SIGNATURE_CONFIRMATION", //New VAS Element
"rateItemNameLocalization": "Signature Confirmation",
"rateItemType": "MANDATORY"
},
{
"rateItemCharge": {
"unit": "GBP",
"value": 3.37
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
}
],
"requiresAdditionalInputs": false,
"serviceId": "SWA-UK-2D",
"serviceName": "Amazon Shipping Two Day",
"supportedDocumentSpecifications": [
{
"format": "PNG",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
},
{
"format": "ZPL",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
},
{
"format": "PDF",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}
],
"totalCharge": {
"unit": "GBP",
"value": 5.07
},
"totalChargeWithCredits": null
}
],
"ineligibleRates": [
{
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"ineligibilityReasons": [
{
"code": "UNKNOWN",
"message": "We apologize for the inconvenience. We cannot ship the order due to an internal service error. Please contact us for additional support. (S-900)"
}
],
"serviceId": "SWA-UK-PREM",
"serviceName": "Amazon Shipping Premium"
},
{
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"ineligibilityReasons": [
{
"code": "NO_COVERAGE",
"message": "We apologize for the inconvenience. We cannot ship the order because there are currently no shipping services available for the recipient address. Please validate the recipient address and try again. If address is accurate, please ship these orders with a different shipping provider. (Code: A-300)"
}
],
"serviceId": "SWA-UK-ECON",
"serviceName": "Amazon Shipping Standard"
}
],
"requestToken": "amzn1.rq.87283887737561.100"
}
}
{
"shipTo": {
"name": "TEST ",
"addressLine1": "XX XX Road",
"city": "Ashtead",
"stateOrRegion": "Surrey",
"postalCode": "XXX XXX",
"countryCode": "GB",
"phoneNumber": "44012345678",
"email": "[email protected]"
},
"shipFrom": {
"name": "TEST Seller",
"addressLine1": "XX XXX",
"city": "Milton Keynes",
"countryCode": "GB",
"postalCode": "XXX XXX",
"email": "[email protected]"
},
"valueAddedServices": {
"otpOnDelivery": { //New VAS element
}
},
"packages": [{
"dimensions": {
"length": 10,
"width": 10,
"height": 10,
"unit": "CENTIMETER"
},
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"items": [{
"description": "VAS Test Item",
"itemValue": {
"unit": "GBP",
"value": 10
},
"itemIdentifier": "100100100100",
"quantity": 1,
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"isHazmat": false
}],
"isHazmat": false,
"insuredValue": {
"unit": "GBP",
"value": 10
},
"packageClientReferenceId": "ORDER123"
}],
"channelDetails": {
"channelType": "EXTERNAL"
}
}
{
"payload": {
"ineligibleRates": [{
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"ineligibilityReasons": [{
"code": "UNKNOWN",
"message": "We apologize for the inconvenience. We cannot ship the order due to an internal service error. Please contact us for additional support. (S-900)"
}],
"serviceId": "SWA-UK-PREM",
"serviceName": "Amazon Shipping Premium"
}, {
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"ineligibilityReasons": [{
"code": "NO_COVERAGE",
"message": "We apologize for the inconvenience. We cannot ship the order because there are currently no shipping services available for the recipient address. Please validate the recipient address and try again. If address is accurate, please ship these orders with a different shipping provider. (Code: A-300)"
}],
"serviceId": "SWA-UK-ECON",
"serviceName": "Amazon Shipping Standard"
}],
"rates": [{
"benefits": null,
"billedWeight": {
"unit": "KILOGRAM",
"value": 1.0
},
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"creditItemList": null,
"paymentType": null,
"promise": {
"deliveryWindow": {
"end": "2025-06-04T19:00:00Z",
"start": "2025-06-04T19:00:00Z"
},
"pickupWindow": {
"end": "2025-06-02T19:00:00Z",
"start": "2025-06-02T17:30:00Z"
}
},
"rateId": "0435f7f9b784afc1a56ce39e78760ae780c3f9c78f02703f9790a3e60cc63c4f1748871335968",
"rateItemList": [{
"rateItemCharge": {
"unit": "GBP",
"value": 1.7
},
"rateItemID": "OTP_ON_DELIVERY_FEE",
"rateItemNameLocalization": "One time password fee",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 3.37
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
}],
"requiresAdditionalInputs": false,
"serviceId": "SWA-UK-2D",
"serviceName": "Amazon Shipping Two Day",
"supportedDocumentSpecifications": [{
"format": "PNG",
"printOptions": [{
"supportedDPIs": [300, 203],
"supportedDocumentDetails": [{
"isMandatory": true,
"name": "LABEL"
}],
"supportedFileJoiningOptions": [false],
"supportedPageLayouts": ["DEFAULT"]
}],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}, {
"format": "ZPL",
"printOptions": [{
"supportedDPIs": [300, 203],
"supportedDocumentDetails": [{
"isMandatory": true,
"name": "LABEL"
}],
"supportedFileJoiningOptions": [false],
"supportedPageLayouts": ["DEFAULT"]
}],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}, {
"format": "PDF",
"printOptions": [{
"supportedDPIs": [300, 203],
"supportedDocumentDetails": [{
"isMandatory": true,
"name": "LABEL"
}],
"supportedFileJoiningOptions": [false],
"supportedPageLayouts": ["DEFAULT"]
}],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}],
"totalCharge": {
"unit": "GBP",
"value": 5.07
},
"totalChargeWithCredits": null
}],
"requestToken": "amzn1.rq.87283887737561.100"
}
}
2- Purchase Shipment (/shipping/v2/shipments):
Note: No additional VAS-related input is needed in the PurchaseShipment request. As usual please use the rateId from the GetRates response that corresponds to your selected shipping service.
{
"requestToken": "amzn1.rq.87283887737561.100",
"rateId": "0435f7f9b784afc1a56ce39e78760ae780c3f9c78f02703f9790a3e60cc63c4f1748871335968",
"requestedDocumentSpecification": {
"format": "PNG",
"size": {
"length": 6,
"unit": "INCH",
"width": 4
},
"dpi": 300,
"pageLayout": "DEFAULT",
"needFileJoining": false,
"requestedDocumentTypes": [
"LABEL"
]
}
}
3- OneClick Shipment (/shipping/v2/oneClickShipment):
{
"shipTo": {
"name": "TEST ",
"addressLine1": "XX XXX",
"city": "Ashtead",
"stateOrRegion": "Surrey",
"postalCode": "XXX XXX",
"countryCode": "GB",
"phoneNumber": "44012345678",
"email": "[email protected]"
},
"shipFrom": {
"name": "TEST Seller",
"addressLine1": "XX XXXX",
"city": "Milton Keynes",
"countryCode": "GB",
"postalCode": "XXX XXX",
"email": "[email protected]"
},
"valueAddedServices": { //New value added service field
"signatureOnDelivery": {
}
},
"packages": [{
"dimensions": {
"length": 10,
"width": 10,
"height": 10,
"unit": "CENTIMETER"
},
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"items": [{
"description": "VAS Test Item",
"itemValue": {
"unit": "GBP",
"value": 10
},
"productType": "SWAYAM ",
"itemIdentifier": "100100100100",
"quantity": 1,
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"isHazmat": false,
"sellerDisplayName": "SWAYAM SELLER"
}],
"sellerDisplayName": "SWAYAM SELLER",
"isHazmat": false,
"insuredValue": {
"unit": "GBP",
"value": 10
},
"packageClientReferenceId": "ORDER123"
}],
"channelDetails": {
"channelType": "EXTERNAL"
},
"labelSpecifications": {
"format": "PNG",
"size": {
"length": 6,
"width": 4,
"unit": "INCH"
},
"dpi": 203,
"pageLayout": "DEFAULT",
"needFileJoining": false,
"requestedDocumentTypes": ["LABEL"]
}
}
{
"payload": {
"carrier": {
"id": "AMZN_UK",
"name": "Amazon Shipping"
},
"packageDocumentDetails": [{
"packageClientReferenceId": "ORDER123",
"packageDocuments": [{
"contents": "<**-redacted-**>",
"format": "PNG",
"type": "LABEL"
}],
"trackingId": "UK2875648663"
}],
"rateItems": [{
"rateItemCharge": {
"unit": "GBP",
"value": 1.7
},
"rateItemID": "SIGNATURE_CONFIRMATION",
"rateItemNameLocalization": "Signature Confirmation",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 3.37
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
}],
"promise": {
"deliveryWindow": {
"__type": "com.amazon.shipping.api.model#DateTimeRange",
"end": "2025-06-02T19:00:00Z",
"start": "2025-06-02T19:00:00Z"
},
"pickupWindow": {
"__type": "com.amazon.shipping.api.model#DateTimeRange",
"end": "2025-06-01T12:45:00Z",
"start": "2025-06-01T12:15:00Z"
}
},
"service": {
"id": "SWA-UK-PREM",
"name": "Amazon Shipping One Day"
},
"shipmentId": "amzn1.sid.97693197381949.100",
"totalCharge": {
"unit": "GBP",
"value": 5.07
}
}
}
{
"shipTo": {
"name": "TEST ",
"addressLine1": "XX XX Road",
"city": "Ashtead",
"stateOrRegion": "Surrey",
"postalCode": "XXXX XX",
"countryCode": "GB",
"phoneNumber": "44012345678",
"email": "[email protected]"
},
"shipFrom": {
"name": "TEST Seller",
"addressLine1": "XX XXX",
"city": "Milton Keynes",
"countryCode": "GB",
"postalCode": "XXX XXX",
"email": "[email protected]"
},
"valueAddedServices": { //New value added service field
"otpOnDelivery": {
}
},
"packages": [{
"dimensions": {
"length": 10,
"width": 10,
"height": 10,
"unit": "CENTIMETER"
},
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"items": [{
"description": "VAS Test Item",
"itemValue": {
"unit": "GBP",
"value": 10
},
"productType": "SWAYAM ",
"itemIdentifier": "100100100100",
"quantity": 1,
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"isHazmat": false,
"sellerDisplayName": "SWAYAM SELLER"
}],
"sellerDisplayName": "SWAYAM SELLER",
"isHazmat": false,
"insuredValue": {
"unit": "GBP",
"value": 10
},
"packageClientReferenceId": "ORDER123"
}],
"channelDetails": {
"channelType": "EXTERNAL"
},
"labelSpecifications": {
"format": "PNG",
"size": {
"length": 6,
"width": 4,
"unit": "INCH"
},
"dpi": 203,
"pageLayout": "DEFAULT",
"needFileJoining": false,
"requestedDocumentTypes": ["LABEL"]
}
}
{
"payload": {
"carrier": {
"id": "AMZN_UK",
"name": "Amazon Shipping"
},
"packageDocumentDetails": [{
"packageClientReferenceId": "ORDER123",
"packageDocuments": [{
"contents": "<**-redacted-**>",
"format": "PNG",
"type": "LABEL"
}],
"trackingId": "UK2875648663"
}],
"rateItems": [{
"rateItemCharge": {
"unit": "GBP",
"value": 1.7
},
"rateItemID": "OTP_ON_DELIVERY_FEE",
"rateItemNameLocalization": "One time password fee",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 3.37
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
}],
"promise": {
"deliveryWindow": {
"__type": "com.amazon.shipping.api.model#DateTimeRange",
"end": "2025-06-02T19:00:00Z",
"start": "2025-06-02T19:00:00Z"
},
"pickupWindow": {
"__type": "com.amazon.shipping.api.model#DateTimeRange",
"end": "2025-06-01T12:45:00Z",
"start": "2025-06-01T12:15:00Z"
}
},
"service": {
"__type": "com.amazon.shipping.api.model.v2#Service",
"id": "SWA-UK-PREM",
"name": "Amazon Shipping One Day"
},
"shipmentId": "amzn1.sid.97693197381949.100",
"totalCharge": {
"__type": "com.amazon.shipping.api.model.v2#Currency",
"unit": "GBP",
"value": 5.07
}
}
}
4- Exceptions:
//When VAS request considered as ineligible
{
"payload": {
"ineligibleRates": [
{
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"ineligibilityReasons": [
{
"code": "UNKNOWN",
"message": "We apologize for the inconvenience. We cannot ship the order because we are unable to provide the requested value-added service or no shipping services are available for the recipient address. Please try again without value-added services or ship with a different carrier."
}
],
"serviceId": "SWA-UK-ECON",
"serviceName": "Amazon Shipping Standard"
}
],
"rates": [
{
"availableValueAddedServiceGroups": [
{
"groupDescription": "Confirmation",
"groupId": "VAS_GROUP_ID_CONFIRMATION",
"isRequired": true,
"valueAddedServices": [
{
"cost": null,
"id": "SIGNATURE_CONFIRMATION",
"name": "Signature confirmation"
}
]
}
],
"benefits": null,
"billedWeight": {
"unit": "KILOGRAM",
"value": 1.0
},
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"creditItemList": null,
"paymentType": null,
"promise": {
"deliveryWindow": {
"end": "2025-07-03T19:00:00Z",
"start": "2025-07-03T19:00:00Z"
},
"pickupWindow": {
"end": "2025-07-01T19:00:00Z",
"start": "2025-07-01T17:30:00Z"
}
},
"rateId": "b122c13e89503c6a7eb785edeabe10d4ace7805031d6468f149bed2e72385c211751376816568",
"rateItemList": [
{
"rateItemCharge": {
"unit": "GBP",
"value": 1.11
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
},
{
"rateItemCharge": {
"unit": "GBP",
"value": 1.0
},
"rateItemID": "SIGNATURE_CONFIRMATION",
"rateItemNameLocalization": "Signature confirmation",
"rateItemType": "MANDATORY"
}
],
"requiresAdditionalInputs": false,
"serviceId": "SWA-UK-2D",
"serviceName": "Amazon Shipping Two Day",
"supportedDocumentSpecifications": [
{
"format": "PNG",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
},
{
"format": "ZPL",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
},
{
"format": "PDF",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}
],
"totalCharge": {
"unit": "GBP",
"value": 2.26
},
"totalChargeWithCredits": null
},
{
"availableValueAddedServiceGroups": [
{
"groupDescription": "Confirmation",
"groupId": "VAS_GROUP_ID_CONFIRMATION",
"isRequired": true,
"valueAddedServices": [
{
"cost": null,
"id": "SIGNATURE_CONFIRMATION",
"name": "Signature confirmation"
}
]
}
],
"benefits": null,
"billedWeight": {
"unit": "KILOGRAM",
"value": 1.0
},
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"creditItemList": null,
"paymentType": null,
"promise": {
"deliveryWindow": {
"end": "2025-07-02T19:00:00Z",
"start": "2025-07-02T19:00:00Z"
},
"pickupWindow": {
"end": "2025-07-01T19:00:00Z",
"start": "2025-07-01T17:30:00Z"
}
},
"rateId": "676cb7101cf1b53d30e035aea344386d5335149a2b18e0a8cea844fe00755bed1751376816567",
"rateItemList": [
{
"rateItemCharge": {
"unit": "GBP",
"value": 3.79
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
},
{
"rateItemCharge": {
"unit": "GBP",
"value": 1.0
},
"rateItemID": "SIGNATURE_CONFIRMATION",
"rateItemNameLocalization": "Signature confirmation",
"rateItemType": "MANDATORY"
}
],
"requiresAdditionalInputs": false,
"serviceId": "SWA-UK-PREM",
"serviceName": "Amazon Shipping One Day",
"supportedDocumentSpecifications": [
{
"format": "PNG",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
},
{
"format": "ZPL",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
},
{
"format": "PDF",
"printOptions": [
{
"supportedDPIs": [
300,
203
],
"supportedDocumentDetails": [
{
"isMandatory": true,
"name": "LABEL"
}
],
"supportedFileJoiningOptions": [
false
],
"supportedPageLayouts": [
"DEFAULT"
]
}
],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}
],
"totalCharge": {
"unit": "GBP",
"value": 4.94
},
"totalChargeWithCredits": null
}
],
"requestToken": "amzn1.rq.87146124768729.100"
}
}
// When incompatible value-added services are selected
{
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input",
"details": "We apologize for the inconvenience. We cannot ship the order because you have selected incompatible value-added services. These services cannot be applied to the same label. Please refer to our API documentation to confirm compatible value-added services. (S-302)"
}
]
}
// When VAS fails eligibility checks
{
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input",
"details": "We apologize for the inconvenience. We cannot ship the order because the eligibility criteria for the selected value-added service were not met. Please refer to our API documentation to learn about the eligibility criteria or try again without value-added services. (S-304)"
}
]
}
// When requested value-added service is not available in country (e.g. US, FR,IT,ES,IN)
{
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input",
"details": "We apologize for the inconvenience. We cannot ship the order because the requested value-added service is not yet available in this region. Please ship without value-added services or use a different carrier. We will notify you when this service becomes available in your region. (S-303)"
}
]
}
What's Next?
The Value Added Services feature will be expanded to support additional marketplaces in future releases. We plan to enable these delivery verification services for other OFF Amazon marketplaces and introduce additional value-added features based on marketplace requirements.
FAQs:
- What Value Added Services does Amazon Shipping offer?
Amazon Shipping offers two delivery verification services: Signature on Delivery (SoD) and One Time Pass-code (OTP). These services provide enhanced security and delivery confirmation options for your shipments. - Who can use the Value Added Services feature?
Amazon shipping OFF Amazon shippers in the United Kingdom can use this feature, starting from XX. - How do I get started with Value Added Services?
To get started, review the updated Amazon Shipping V2 API documentation. You can use either the GetRatesV2 with Purchase flow or the oneClickShipment API. For GetRatesV2, specify the VAS requirement in your request and use the returned rate ID for purchase. For oneClickShipment API, include the VAS specification directly in your request. - Can I use both OTP and Signature confirmation for the same shipment?
No, only one Value Added Service can be enabled per shipment. You must choose either OTP or Signature confirmation. - What are the new enum values added for Value Added Services?
The rate item ID now includes a new value "OTP_ON_DELIVERY_FEE" while continuing to support "SIGNATURE_CONFIRMATION" for signature verification services. - What happens if I don't request any VAS in my API call?
If no VAS is requested, the system will return standard shipping rates without any value added services. - What are the prerequisites for OTP service?
For OTP service, you need to ensure:- A valid phone number is provided in the shipTo address
- The delivery is not to an access point
- The shipment doesn't have collectOnDelivery VAS
- SMS recipient notification toggle is enabled for your shipper account
- What are the prerequisites for Signature confirmation?
For Signature confirmation service, the only requirement is that the delivery should not be to an access point. - What happens if the requested VAS isn't supported for my shipment?
If the requested VAS isn't supported for your shipment (e.g., requesting OTP without a valid phone number), the API call will fail with an appropriate error message explaining why the service cannot be provided. - Is the valueAddedServiceDetails object in OneClickShipment API being phased out?
Yes, the valueAddedServiceDetails object (currently used only for CollectOnDelivery in India marketplace) will be phased out. We recommend IN marketplace developers to start using the new valueAddedServices field for better consistency across all marketplaces. - Why are we moving to the new valueAddedServices field?
The new valueAddedServices field provides a standardized way to handle all Value Added Services across different marketplaces. This unified approach simplifies integration, improves consistency, and allows for easier addition of future services. - How should I transition from valueAddedServiceDetails to the new valueAddedServices field?
For new implementations, please use the valueAddedServices field. If you're currently using valueAddedServiceDetails for CollectOnDelivery in India marketplace, you can continue using it, but we recommend planning your transition to the new valueAddedServices field as it will be the standard format for all future Value Added Services. - What will be the charges associated with these value-added services?
The rates for One-Time Passcode (OTP) Delivery and Signature on Delivery (SOD) will be available within your Amazon Shipping account once the services are fully launched. We will send out a separate communication on pricing information, and you will have the opportunity to review the rates before being charged for OTP or SOD.