Confirm Delivery

POST/fina/v1/orders/confirm_delivery

Marks an order as delivered by submitting a proof of delivery (POD), such as an image or document URL. Required for downstream reconciliation.

delivery_proof_url is fetched server-side

FINA downloads the file at delivery_proof_url and re-hosts it, so the URL must point at a real, reachable image or document. A placeholder or auth-protected link fails. An expiring pre-signed link (e.g. S3/GCS) works fine as long as it is still valid when you call this endpoint.

Request

order_idstringrequired

The order_id returned by Initiate Checkout.e.g. F26070910AB3XKQ70

delivery_proof_urlstringrequiredmust be fetchable without authentication

URL of the proof of delivery (image or document). FINA fetches it server-side, so it must resolve without authentication — an expiring pre-signed link (e.g. S3/GCS) works fine as long as it is still valid when you call this endpoint.e.g. https://example.com/pod/ORD-2026-0001.jpg

confirmation_typeenum

How delivery is being confirmed. Defaults to proof-of-delivery — leave it unset unless FINA has enabled OTP delivery confirmation for you.PODOTP

Response

error_codestring

Numeric code as a string; "0" on success.

errorsarray

Failure details, empty on success.

messagestring

Human-readable status.

successboolean

true when delivery was confirmed.

object

The delivered order.

order_idstring

FINA's order identifier.

order_reference_idstring

Your order reference.

order_statusstring

"DELIVERED" on success.

Errors

Returned as HTTP 200 with a non-zero error_code — see Error Handling.

Code	Name	Description	Resolution
`400`	INVALID_PARAMS	A required field is missing or a value failed validation (e.g. totals don't reconcile, invalid phone format, unknown field value).	Check errors[] for the failing field. Ensure order.total_amount equals the sum of items[].total_amount plus shipping_amount minus discount_amount.
`808`	INVALID_ORDER	No order was found for the given order_id / order_number.	Use the order_id returned by Initiate Checkout.
`811`	INVALID_ORDER_STATE	The order is not in a state that allows this operation (e.g. authorising an expired order, confirming delivery on an unauthorised order).	Check the order lifecycle; only perform operations valid for the order's current status.
`500`	INTERNAL_ERROR	An unexpected failure occurred on FINA's side.	Retry with backoff; contact FINA support if it persists.

Sandboxhttps://apibe.silqfi.xyz

POST /fina/v1/orders/confirm_delivery

curl -X POST "https://apibe.silqfi.xyz/fina/v1/orders/confirm_delivery" \
  -H "Authorization: bearer FINA_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "F26070910AB3XKQ70",
    "delivery_proof_url": "https://example.com/pod/ORD-2026-0001.jpg"
  }'

FINA_BEARER_TOKEN is provided by the FINA team, per environment. Contact the FINA team for the production base URL.

Response · 200 · Success

{
  "error_code": "0",
  "errors": [],
  "message": "Delivery confirmed successfully",
  "data": {
    "order_id": "F26070910AB3XKQ70",
    "order_reference_id": "ORD-2026-0001",
    "order_status": "DELIVERED"
  },
  "success": true
}

PreviousResend OTP Next Add FINA Invoice