added
Pre-Launch Announcement: Signature on Delivery(SoD) for UK Amazon Marketplace (ON-Amazon)
12 days ago
We are excited to expand our Value Added Service (VAS) offering to include Signature on Delivery (SoD) for ON-Amazon marketplace volume in the United Kingdom. This feature, previously available only for OFF-Amazon shipments, now provides enhanced delivery security and verification for Amazon marketplace orders.
Why is this important?
The Amazon Shipping API enables programmatic access to Amazon Shipping services. With the expansion of Signature on Delivery to ON-Amazon volume, you can now implement secure delivery verification for your UK marketplace orders using the same valueAddedServices field structure introduced for OFF-Amazon shipments. This feature ensures packages are delivered to verified recipients, reducing delivery risks and enhancing security for high-value marketplace orders.
When will this change be launched?
The Value Added Services will be available in April 2026 for On-Amazon Shippers in the UK marketplace only.
Value Added Service details:
With this launch, you'll be able to add Signature on Delivery (SoD) for Amazon Logistics (AMZL) deliveries on UK marketplace orders:
- Signature on Delivery (SoD): Request signature verification for your shipments when packages are delivered using Amazon Logistics (AMZL) delivery.
How can I add Signature on Delivery to my ON-Amazon shipments?
- Signature on Delivery will be made available via Amazon Shipping V2 API (GetRatesV2 API and oneClickShipment API for ON-Amazon).
- For GetRatesV2 + Purchase flow, simply specify signatureOnDelivery in the valueAddedServices field in the GetRatesV2 request. The response will return rates that support SoD, and the VAS requirement 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 SoD if available with the service selection.
Schema Details:
1- ValueAddedServiceDetails - GetRatesV2 API (Request)
2- Rate Item for shipping (base cost, transaction fee, confirmation, insurance, etc.)
Note: RateItemID includes SIGNATURE_CONFIRMATION for signature confirmation charge.
How It Works:
1- GetRatesV2 (/shipping/v2/shipments/rates):
{
"shipTo": {
"name": "John Doe",
"addressLine1": "123 High Street",
"city": "London",
"stateOrRegion": "Greater London",
"countryCode": "GB",
"postalCode": "SW1A 1AA",
"email": "[email protected]",
"phoneNumber": "+44 20 1234 5678"
},
"shipFrom": {
"name": "Warehouse UK",
"addressLine1": "456 Industrial Park",
"stateOrRegion": "Manchester",
"postalCode": "M1 1AA",
"city": "Manchester",
"countryCode": "GB",
"email": "[email protected]",
"phoneNumber": "+44 161 123 4567"
},
"valueAddedServices": { // SOD VAS
"signatureOnDelivery": {}
},
"packages": [{
"dimensions": {
"length": 10,
"width": 10,
"height": 10,
"unit": "CENTIMETER"
},
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"items": [{
"quantity": 1,
"itemIdentifier": "SKU123456",
"description": "Sample Product",
"isHazmat": false,
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"itemValue": {
"unit": "GBP",
"value": 25.00
}
}],
"insuredValue": {
"unit": "GBP",
"value": 25.00
},
"packageClientReferenceId": "ORDER123"
}],
"channelDetails": {
"channelType": "AMAZON",
"amazonOrderDetails": {
"orderId": "123-4567890-1234567"
}
}
}
{
"payload": {
"rates": [{
"availableValueAddedServiceGroups": [{
"groupDescription": "Pickup",
"groupId": "VAS_GROUP_ID_PICKUP",
"isRequired": true,
"valueAddedServices": [{
"cost": {
"unit": "GBP",
"value": 0.0
},
"id": "CARRIER_PICKUP_CHARGE",
"name": "Carrier Pickup"
}]
}],
"benefits": {
"excludedBenefits": [],
"includedBenefits": ["CLAIMS_PROTECTED"]
},
"carrierId": "AMZN_UK",
"carrierName": "Amazon Shipping",
"promise": {
"deliveryWindow": {
"end": "2025-12-04T20:00:00Z",
"start": "2025-12-04T20:00:00Z"
},
"pickupWindow": {
"end": "2025-12-03T20:00:00Z",
"start": "2025-12-03T14:30:00Z"
}
},
"rateId": "b95f3d2d-edde-440f-a5df-bca8b6afa460",
"rateItemList": [{
"rateItemCharge": {
"unit": "GBP",
"value": 0.0
},
"rateItemID": "CARRIER_PICKUP_CHARGE",
"rateItemNameLocalization": "Carrier Pickup",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 0.0
},
"rateItemID": "TRACKING_CHARGE",
"rateItemNameLocalization": "Tracking Charge",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 3.11
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 5.0
},
"rateItemID": "FLAT_SURCHARGE",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 0.12
},
"rateItemID": "DEMAND_SURCHARGE",
"rateItemNameLocalization": "Demand Surcharge",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 1.0
},
"rateItemID": "SIGNATURE_CONFIRMATION", //SOD related rateitemid
"rateItemNameLocalization": "Signature confirmation",
"rateItemType": "MANDATORY"
}],
"requiresAdditionalInputs": false,
"serviceId": "prime-premium-uk-mfn",
"serviceName": "Amazon Shipping One-Day Tracked",
"supportedDocumentSpecifications": [{
"format": "PNG",
"printOptions": [{
"supportedDPIs": [300, 203],
"supportedDocumentDetails": [{
"isMandatory": true,
"name": "LABEL"
}],
"supportedFileJoiningOptions": [true],
"supportedPageLayouts": ["LEFT"]
}],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}, {
"format": "ZPL",
"printOptions": [{
"supportedDPIs": [300, 203],
"supportedDocumentDetails": [{
"isMandatory": true,
"name": "LABEL"
}],
"supportedFileJoiningOptions": [true],
"supportedPageLayouts": ["LEFT"]
}],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}, {
"format": "PDF",
"printOptions": [{
"supportedDPIs": [300, 203],
"supportedDocumentDetails": [{
"isMandatory": true,
"name": "LABEL"
}],
"supportedFileJoiningOptions": [true],
"supportedPageLayouts": ["LEFT"]
}],
"size": {
"length": 6.0,
"unit": "INCH",
"width": 4.0
}
}],
"totalCharge": {
"unit": "GBP",
"value": 9.23
},
"totalChargeWithAdjustments": {
"unit": "GBP",
"value": 9.23
}
}],
"ineligibleRates": [],
"requestToken": "amzn1.rq.d4d731eb-5924-4ece-8dc8-2b8ae0c80c5d.101"
}
}
2- Purchase Shipment (/shipping/v2/shipments):
Note: No additional VAS-related input is needed in the PurchaseShipment request. Please continue to use the rateId from the GetRates response that corresponds to your selected shipping service.
{
"requestToken": "amzn1.rq.a4a78f99-ea5b-4d5b-b2d4-59ec6f2898df.101",
"rateId": "fccef856-b5a9-4ec2-8a18-b02d50a80f56",
"requestedDocumentSpecification": {
"format": "PNG",
"needFileJoining": true,
"pageLayout": "LEFT",
"dpi": 300,
"requestedDocumentTypes": ["LABEL"],
"size": {
"width": 4,
"length": 6,
"unit": "INCH"
}
},
"requestedValueAddedServices": [{
"id": "CARRIER_PICKUP_CHARGE"
}]
}
3- OneClick Shipment (/shipping/v2/oneClickShipment):
{
"shipFrom": {
"name": "Warehouse UK",
"addressLine1": "456 Industrial Park",
"postalCode": "M1 1AA",
"stateOrRegion": "Manchester",
"city": "Manchester",
"countryCode": "GB",
"email": "[email protected]",
"phoneNumber": "+44 161 123 4567"
},
"shipTo": {
"name": "John Doe",
"addressLine1": "123 High Street",
"postalCode": "SW1A 1AA",
"stateOrRegion": "Greater London",
"city": "London",
"countryCode": "GB",
"email": "[email protected]",
"phoneNumber": "+44 20 1234 5678"
},
"valueAddedServices": { //VAS with SOD
"signatureOnDelivery": {}
},
"labelSpecifications": {
"size": {
"unit": "INCH",
"width": 4,
"length": 6
},
"pageLayout": "DEFAULT",
"requestedDocumentTypes": ["LABEL"],
"format": "PNG",
"needFileJoining": false,
"dpi": 203
},
"serviceSelection": {
"serviceId": ["std-uk-mfn"]
},
"packages": \[{
"dimensions": {
"length": 10,
"width": 10,
"height": 10,
"unit": "CENTIMETER"
},
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"items": [{
"quantity": 1,
"itemIdentifier": "SKU123456",
"description": "Sample Product",
"isHazmat": false,
"weight": {
"value": 1,
"unit": "KILOGRAM"
},
"itemValue": {
"unit": "GBP",
"value": 25.00
}
}],
"insuredValue": {
"unit": "GBP",
"value": 25.00
},
"packageClientReferenceId": "ORDER123"
}],
"channelDetails": {
"channelType": "AMAZON",
"amazonOrderDetails": {
"orderId": "123-4567890-1234567"
}
}
}
{
"payload": {
"carrier": {
"id": "AMZN_UK",
"name": "Amazon Shipping"
},
"packageDocumentDetails": [{
"packageClientReferenceId": "Shipment_1715160081980",
"packageDocuments": [{
"contents": "<base64-encoded-label>",
"format": "PNG",
"type": "LABEL"
}],
"trackingId": "UK2875648663"
}],
"rateItems": [{
"rateItemCharge": {
"unit": "GBP",
"value": 1.0
},
"rateItemID": "SIGNATURE_CONFIRMATION", //VAS related rateitemid
"rateItemNameLocalization": "Signature Confirmation",
"rateItemType": "MANDATORY"
}, {
"rateItemCharge": {
"unit": "GBP",
"value": 3.37
},
"rateItemID": "BASE_RATE",
"rateItemNameLocalization": "Base Rate",
"rateItemType": "MANDATORY"
}],
"promise": {
"deliveryWindow": {
"end": "2025-06-02T19:00:00Z",
"start": "2025-06-02T19:00:00Z"
},
"pickupWindow": {
"end": "2025-06-01T12:45:00Z",
"start": "2025-06-01T12:15:00Z"
}
},
"service": {
"id": "std-uk-mfn",
"name": "Amazon Shipping Two-Day Tracked"
},
"shipmentId": "amzn1.sid.97693197381949.100",
"totalCharge": {
"unit": "GBP",
"value": 5.07
}
}
}
4- Exceptions:
For all the error scenarios for GetRatesAPI, the Error response would be generic i.e.
{
"errors": [
{
"code": "InternalServerError",
"message": "We encountered an internal error. Please try again.",
"details": "The API has faced an Unknown Error"
}
]
}
What's Next?
The Value Added Services feature will continue to expand to support additional marketplaces and services in future releases.
FAQs:
- Which UK service IDs support Signature on Delivery for ON-Amazon orders?
Signature on Delivery is not service-specific. It is available for all eligible Amazon Logistics (AMZL) services in the UK marketplace, including: prime-premium-uk-mfn (Amazon Shipping One-Day Tracked) std-uk-mfn (Amazon Shipping Two-Day Tracked) econ-uk-mfn (Amazon Shipping Standard) - Is this the same implementation as OFF-Amazon VAS?
Yes, the implementation is identical to the OFF-Amazon VAS launched in 2025. The same valueAddedServices field structure is used for both ON-Amazon and OFF-Amazon shipments. - Do I need to update my integration if I'm already using VAS for OFF-Amazon?
No changes are required. If you're already using the valueAddedServices field for OFF-Amazon shipments, the same implementation works for ON-Amazon orders. Simply ensure channelType is set to "AMAZON" and include the amazonOrderDetails with the orderId. - What are the prerequisites for Signature on Delivery?
For Signature on Delivery service, the only requirement is that the delivery should not be to an access point. The service is available only for AMZL deliveries. - What happens if I request SoD but it's not available 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. - How does the new valueAddedServices field interact with the existing availableValueAddedServiceGroups?
When a Value Added Service is requested in the GetRatesV2 request using the valueAddedServices field, the response will not include the requested VAS in the availableValueAddedServiceGroups. The VAS is automatically applied and does not need to be specified again in the PurchaseShipment request's requestedValueAddedServices. - What are the charges for Signature on Delivery?
The charges for Signature on Delivery are included in the rateItemList response with rateItemID: "SIGNATURE_CONFIRMATION". Pricing is available in your Amazon Shipping account and will be reflected in the rate response. - Will ON-Amazon VAS be available in Dynamic/Enhanced Sandbox for testing?
No, VAS ON Amazon is not available in Enhanced Sandbox at the moment. - Will OTP be supported as ON-Amazon VAS ?
No, OTP as VAS for ON Amazon is not available at the moment. - Is it available for OFF-Amazon volume?
Yes, this is available for OFF-Amazon volume, please refer Launch Announcement VAS For UK Off Amazon