Velourcity
Back to Docs

Deeplinks Integration

Integrate delivery features into your mobile or web application using deeplinks. Redirect users to the Velourcity app with pre-populated delivery information.

Simple • Fast Setup • No API Keys Required
URL Format

Basic structure for Velourcity deeplinks

Base URL

https://app.velourcity.com/delivery

Complete Example

https://app.velourcity.com/delivery?pickup_address=123%20Restaurant%20St&dropoff_address=456%20Customer%20Ave&partner_id=your_partner_id&callback_url=https://yourapp.com/delivery/complete
URL Parameters

Available parameters for customizing the delivery request

pickup_address Required

Full pickup address including street, city, and postal code.

dropoff_address Required

Full delivery address including street, city, and postal code.

partner_id Required

Your unique partner identifier for tracking and attribution.

callback_url Optional

URL to redirect users back to your app after completing the delivery request.

delivery_instructions Optional

Special instructions for the delivery driver.

reference_id Optional

Your internal reference ID for this delivery request.

Implementation Examples

Code examples for different platforms and languages

JavaScript / React

Android (Java)
Best Practices

✅ Do

  • • URL encode all parameter values
  • • Validate addresses before creating links
  • • Provide clear user feedback
  • • Handle app not installed scenarios
  • • Use HTTPS for callback URLs

❌ Don't

  • • Include sensitive information in URLs
  • • Assume the app is always installed
  • • Use invalid or placeholder addresses
  • • Forget to handle callback responses
  • • Hardcode partner IDs in client code

Ready to integrate deeplinks?

Get your partner ID and start redirecting users to Velourcity for seamless delivery experiences.

Get Partner ID