Submit proof of payment

After the payer completes the bank transfer, submit proof with: POST /business/treasury/deposits/{id}/proof Request body: multipart/form-data (not JSON). Send two form fields in the same request:

Field	Type	Description
`bankId`	text	The `id` of the bank account used, from the create deposit response (for example `"1"`)
`proof`	file	Proof of payment as a PDF or image (JPEG, PNG, or WebP)

The API updates the deposit from waiting_pop to pending and stores the proof URL on the record. The deposit id stays the same.

POST /business/treasury/deposits/{id}/proof (multipart/form-data)

curl -s -X POST "https://b2b-api.easyonramp.com/api/v1/business/treasury/deposits/DEPOSIT_ID/proof" \
  -H "Authorization: Bearer YOUR_JWT" \
  -F "bankId=1" \
  -F "proof=@/path/to/proof-of-payment.pdf;type=application/pdf"

fetch with FormData

const form = new FormData();
form.append('bankId', '1');
form.append('proof', proofFile); // File or Blob from an <input type="file">

const response = await fetch(
  `https://b2b-api.easyonramp.com/api/v1/business/treasury/deposits/${depositId}/proof`,
  {
    method: 'POST',
    headers: { Authorization: `Bearer ${jwt}` },
    body: form,
  },
);
// Do not set Content-Type manually: the browser adds the multipart boundary.

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440003",
  "proofUrl": "https://b2b-api.easyonramp.com/api/v1/business/treasury/deposits/550e8400-e29b-41d4-a716-446655440003/proof"
}

proofUrl is the public download URL for the uploaded file. No authentication is required. It is also returned on GET /business/treasury/deposits/{id} after proof is submitted.

When to call this

Stage	What to do
Deposit created (`waiting_pop`), transfer not yet sent	Wait, then submit proof after the transfer
Transfer sent, status `waiting_pop`	Submit proof with the correct `bankId`
Status already `pending`	Deposit is in ops review; poll status or use webhooks

Proof can only be submitted once per deposit while it is still awaiting submission.

Next step

See Deposit status for approval, decline, and expiry. After approval, convert fiat to USDC with Trading if you plan to fund cards.

Submit proof of payment

Get started

Core concepts

Common workflows

How to manage users

How to fund your business wallet

How to use cards

How to use reports

Integration services

When to call this

Next step

​When to call this

​Next step

​Related

When to call this

Next step

Related