Skip to navigation
API ReferencePayment Proof

Read the current payment proof

Read the current payment proof.

Credential: Customer session or partner secret

Before you call

  • A customer session, or an owning partner server credential without Origin.
  • To change proof, the customer must be the fiat payer on a BUY, and the trade must be CREATED, PAID or DISPUTED.
  • Uploads accept PNG or JPEG files up to 3 MiB decoded. Authenticated reads return merchant originals unchanged.

Returns private proof metadata and original file in dataBase64 only to the owning customer. The base64 field is a small blurred JPEG preview (empty for PDF); it is distinct from dataBase64. Reads remain available after settlement; missing proof returns 404.

Storage unavailability can return 502 or 503 UPSTREAM_ERROR. Retry with backoff; contact Sinbad with requestId if it persists.

Confirm with Sinbad that this endpoint is enabled in your environment.

Errors

StatusCodeWhat to do
400VALIDATION_ERRORCorrect the fields reported in details before retrying.
401UNAUTHENTICATEDCreate a new customer session or use a valid server credential.
403FORBIDDENCheck credential ownership, integration and the supplied Origin.
404NOT_FOUNDCheck the resource ID. A resource that belongs to someone else also returns 404.
409CONFLICTRead the current state again before you prepare or retry.
502UPSTREAM_ERRORRetry with backoff and quote requestId if it persists. For transaction reports, retry the same hash without sending another transaction.
503UPSTREAM_ERRORRetry with backoff; preserve the same idempotency key for a repeated mutation.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

tradeIdstringRequired

Response

Proof metadata, contentType and dataBase64.
proofIdstring
contentTypestring

Original content type; merchant files can use native image formats.

sizeinteger>=1
uploadedByRoleenum
Allowed values:
uploadedAtdatetime or null
base64string
Blurred preview, not original file bytes.
widthdouble>=0
heightdouble>=0
dataBase64string
Original file bytes encoded as raw base64 without a data URI prefix.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
502
Bad Gateway Error
503
Service Unavailable Error