Deposit requests

Get the Proof of Payment

GET/v1/deposit-requests/{id}/proof

Retrieves the Proof of Payment for a settled request.

API key · or dashboard session.

Request

Shell
curl -fsS "$API/v1/deposit-requests/dr_0198f80c-…/proof" \
  -H "Authorization: Bearer $PAYDAY_API_KEY" > proof.json

Response

200 OK
{
  "version": "payday.proof.v4",
  "payment_id": "dr_0198f80c-8d2f-7dc1-a369-90556a64f700",
  "canonical_issuance_snapshot": { "schema": "payday.invoice.v3", "canonicalization": "RFC8785", "networks": [ "…" ], "…": "…" },
  "canonicalization": "RFC8785",
  "attribution_hash": "0x…",
  "payer_wallet": { "address": "0x5aAe…", "typed_data": { "…": "…" }, "digest": "0x…", "signature": "0x…", "method": "ecdsa" },
  "salt": "0x…",
  "chain_id": "143",
  "factory_address": "0x…",
  "payment_address": "0x2222222222222222222222222222222222222222",
  "token_address": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
  "recovery_address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
  "settlement_transaction_hash": "0x…",
  "transfers": [ { "transaction_hash": "0x…", "log_index": "12", "sender": "0x5aAe…", "recipient": "0x2222…", "amount_base_units": "10500000", "block_number": "98765432" } ],
  "verification": { "payload": { "…": "…" }, "signer": "0x…", "signature": "0x…" }
}

Document version payday.proof.v4: canonical issuance snapshot (with every network offered), attribution hash, payer wallet attestation, salt, the chosen chain, factory, and token, deposit and recovery addresses, credited transfers (a transfer Relay's solver delivered for a payment from another network carries relay: request id, origin chain, origin transaction, origin sender), settlement transaction hash, and a Payday-signed verification attestation whose relay_fills vouch for those origins. Verifiable offline; reference implementation gateway_core::verify_proof. Schema: Proof of Payment.

Path parameters

iddr_ idrequired

Response

ProofOfPayment.

Status codes

  • 200
  • 409deposit_request_not_settled
  • 409deposit_sender_mismatch A credited transfer originated from a wallet other than payer_wallet and is not a Relay delivery attributed to it. No proof is issued.