Skip to main content
POST
Submit a proof

Headers

ApiKey
string
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.

MerchantId
string
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
enum<string>
required

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

Available options:
live,
sandbox

Path Parameters

id
string
required

Body

application/json
blobName
string
required

The blob name returned by the proof upload URI endpoint.

Example:

"proof-3f2504e0-4f89-41d3-9a0c-0305e82c3301"

fileName
string
required

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

Example:

"bank-transfer-receipt.pdf"

contentType
enum<string>
required

The MIME type of the uploaded proof file.

Available options:
image/jpeg,
image/jpg,
image/png,
application/pdf
Example:

"application/pdf"

Response

id
string
required

Unique identifier for the deposit

merchantId
string
required

Merchant identifier

merchantAccountId
string
required

Merchant account identifier

matchingCode
string
required

Reference to use for the bank transfer

amount
number
required

Amount of the deposit

currency
string
required

Currency of the deposit (ISO 4217 format)

accountType
enum<string>
required

Type of merchant account

Available options:
collection,
transfer,
transfer-irt,
delegated,
cross-border
method
object
required

Method used for the deposit

status
enum<string>
required

Status of the deposit

Available options:
created,
failed,
pending,
successful
statusDetails
enum<string>
required

Status details of the deposit

Available options:
waiting_provider,
waiting_proof,
unverified,
verified,
mismatch
mode
enum<string>
required

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

Available options:
live,
sandbox
fees
object[]
required

List of fees associated with the deposit

createdAt
string
required

Date and time when the deposit was created

createdBy
string
required

User id or merchant id who created the deposit

updatedAt
string
required

Date and time when the deposit was last updated

merchantName
string

Merchant display name

description
string

Description of the deposit

Maximum string length: 300
failureCause
object

Optional failure cause details

nextAction
object

Next action required, if any

Legal data of the deposit