Validate shipping address
POST https://delivery-api.paysera.com/rest/v1/validate-address
Validate a shipping address to ensure it's correctly formatted and deliverable.
This endpoint checks:
- Address format and completeness
- Country and city validity
- Postal code format
- Street address structure
Returns validation errors if the address is invalid or suggestions for corrections.
Authorization​
This endpoint requires MAC (Message Authentication Code) authentication.
Authorization Header Format:
Authorization: MAC id="YOUR_PROJECT_ID",ts="1234567890",nonce="xyz123",mac="GENERATED_MAC_HASH"
Example:
Authorization: MAC id="a9b8c7d6e5f4g3h2", ts="1234567890", nonce="xyz123abc456def", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ==", ext="body_hash=cmFuZG9tQm9keUhhc2hWYWx1ZQ%3D%3D"
For more details, please refer to the Authentication section.
Request Body​
| Field | Type | Required | Description |
|---|---|---|---|
country_code | string | ✓ | Country code (ISO 3166-1 alpha-2) |
city | string | ✓ | City name |
street | string | ✓ | Street address |
postal_code | string | ✓ | Postal code |
house_number | string | House number (optional if included in street) |
Example​
Request​
POST https://delivery-api.paysera.com/rest/v1/validate-address
Content-Type: application/json
Authorization: MAC id="YOUR_PROJECT_ID",ts="1234567890",nonce="xyz123",mac="GENERATED_MAC_HASH"
{}
Response​
{}
AUTHORIZATION: HTTP
REQUEST
Base URL
https://delivery-api.paysera.com
RESPONSE
Address validation result
{}