# Upload the Proof of a From-Bank Payment

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

Send the receipt of the user's bank payment for a from_bank order.

## Overview

- The file is the raw request body, with `Content-Type` `application/pdf`, `image/png` or `image/jpeg`, at most 10 MiB (`413` beyond).
- The order moves to `proof_submitted`; the desk checks the payment. A refused proof sets `proofRejectedReason` and the order waits for a new proof.
- `409` `BANK_RAMP_ORDER_PROOF_NOT_EXPECTED` when the order takes no proof now, `BANK_RAMP_ORDER_PROOF_IN_PROGRESS` while one is being sent, `BANK_RAMP_ORDER_PROOF_UNKNOWN` when it is not known whether the last one reached the desk: upload it again.

Called with the user's access token, in one environment (`isTestnet`). See [Bank Ramp: Desk Orders](https://docs.aureahub.com/docs/guide-bank-desk.md).

## Endpoint

### `PUT /v1/ramp/bank/customer/desk/orders/{id}/proof`

Authentication: bearer token required.

Uploads the receipt of the user's bank payment for a from_bank order, as the raw body with its Content-Type: application/pdf, image/png or image/jpeg, at most 10 MiB (413 above).

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | The record's `id` |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |

**Responses**

`200` Proof received

```json
{
  "id": "2b4d6f8a-0c1e-4a3c-9e5b-7d9f1b3d5f62",
  "environment": "production",
  "direction": "from_bank",
  "fromAsset": "MWK",
  "fromAmount": "500000",
  "toAsset": "USDT",
  "toAmount": "281.15",
  "rate": "1778.41",
  "quoteExpiresAt": "2026-10-23T09:01:00.000Z",
  "beneficiary": null,
  "funding": {
    "bankName": "Example Bank Malawi",
    "accountName": "Your Company Ltd",
    "accountNumber": "1002003004",
    "reference": "AUR-7K2Q9M",
    "amount": "500000",
    "asset": "MWK",
    "deadline": "2026-10-24T09:00:00.000Z"
  },
  "status": "proof_submitted",
  "failureCode": null,
  "proofRejectedReason": null,
  "refundStatus": null,
  "expiresAt": "2026-10-24T09:00:00.000Z",
  "createdAt": "2026-10-23T09:00:00.000Z",
  "updatedAt": "2026-10-23T09:14:31.000Z"
}
```

---

Web version: https://docs.aureahub.com/#desk-proof-upload