​

How to Upload a Receipt Image Using a Presigned URL

​

Overview of the Flow

1. Get Upload URL — to obtain a presigned aws s3 url.
2. Create Receipt — to create a receipt referencing the uploaded image via image_path.

​

Step 1 — Request a Presigned Upload URL

​

Example Request

curl -X GET "https://api.thanxsandbox.com/upload_url?upload_type=receipt" \
  -H "Authorization: Bearer <token>" \
  -H "Accept-Version: v4.0"

​

Successful Response

{
  "url": "https://thanx-sandbox.s3.amazonaws.com/uploads/receipt/...",
  "image_path": "uploads/receipt/image_<unique>.jpeg"
}

​

Step 2 — Upload the Image to S3 Using the Presigned URL

​

Correct Upload Using curl

curl -X PUT "presigned_url;" \
  -H "Content-Type: image/jpeg" \
  --data-binary @"my_receipt.jpg"

​

Correct Upload Using Postman

• Method → PUT
• URL → paste the full presigned URL
• Body → select binary
• Click Select File
• Headers → add: Content-Type: image/jpeg

​

Do Not Use

• form-data
• raw
• file upload inside raw
• multipart/form-data These formats produce the error:

Image content type is not a valid image

​

Step 3 — Submit the Receipt

​

Example Request

curl https://api.thanxsandbox.com/receipts \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept-Version: v4.0" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "receipt": {
      "merchant_id": "abc123",
      "amount": 13.45,
      "payment_type": "cash",
      "purchased_at": "2024-09-15T00:52:10.655+00:00",
      "image_path": "uploads/receipt/image_<unique>.jpeg",
      "user_comments": "Card reader was down"
    }
  }'

​

Internal Note

​

Common Errors & Fixes

​

Error: Image content type is not a valid image

​

Error: Image file is empty or corrupted

• Missing --data-binary
• Incorrect Content-Type
• Expired presigned URL

• Correct content type
• URL is still valid
• Upload is binary

​

Summary

• 1 Request presigned URL via /upload_url
• 2 Upload the image to S3 using a PUT binary request
• 3 Submit the receipt using the returned image_path