HUhub2
Deposits

Submit a proof

Changed on

This endpoint allows you to submit a proof for a deposit

post/deposits/{id}/proof

Request

  • The document declares no server URL.
  • Auth
    none declared. Required headers: ApiKey, MerchantId, Environment

Path parameters

idstring required

Headers

ApiKeystring required

Your api key. To create a key, please get into our dashboard. If you don't have access to it, please reach the Support team.

MerchantIdstring required

Your merchant ID. This information is available in our dashboard. If you don't have access to it, please reach the Support team.

Environment'live' | 'sandbox' required

Allow you to choose between the sandbox mode to perform some tests or the live mode for real world transactions.

Request body

blobNamestring required

The blob name returned by the proof upload URI endpoint. Any other name is refused with 400.

fileNamestring required

The original file name as selected by the user (used for download).

contentType'image/jpeg' | 'image/jpg' | 'image/png' | 'application/pdf' required

The MIME type of the uploaded proof file.

Example request

{
  "blobName": "proof-3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "fileName": "bank-transfer-receipt.pdf",
  "contentType": "application/pdf"
}

Response

idstring required

Unique identifier for the deposit

merchantIdstring required

Merchant identifier

merchantNamestring

Merchant display name

merchantAccountIdstring required

Merchant account identifier

matchingCodestring required

Reference to use for the bank transfer

descriptionstring

Description of the deposit

amountnumber required

Amount of the deposit

currencystring required

Currency of the deposit (ISO 4217 format)

accountType'collection' | 'transfer' | 'transfer-irt' | 'delegated' | 'cross-border' required

Type of merchant account

status'created' | 'failed' | 'pending' | 'successful' required

Status of the deposit

statusDetails'waiting_provider' | 'waiting_proof' | 'unverified' | 'verified' | 'mismatch' required

Status details of the deposit

mode'live' | 'sandbox' required

Application mode (e.g., live or sandbox)

feesDepositFee[] required

List of fees associated with the deposit

createdAtstring required

Date and time when the deposit was created

createdBystring required

User id or merchant id who created the deposit

updatedAtstring required

Date and time when the deposit was last updated

nextActionobject

Next action required, if any

Example response

{
  "method": {
    "type": "bank_transfer",
    "hub2Iban": "FR7630006000011234567890189",
    "country": "FR",
    "provider": "ecobank"
  }
}

Changes