Skip to content

Proof

This transaction is used to send the confirmation of the payment made by the customer in a 3rd party applciation. The transaction request contains a file with the transaction confirmation.

Request

POST https://api.ecomcharge.com/beyag/transactions/{uid}/proof
object
skip_duplicate_check
 boolean
If false, declines a request if the request with the same uid was sent within 30 seconds prior to it. By default, set to false.
amount
required
 bigInteger
Payment proof amount in minimal currency units without coins.
currency
required
 string (3)
Transaction currency in the ISO-4217 alpha-3 code format.
transaction_reference
 string
Receipt or reference number of the transaction.
object
content_type
required

 string
application/pdf
image/png
image/jpeg
file_name
required

 string
File name including the file extension.
file_size
required
 integer
File size in bytes.
content
required
 string
Payment proof documents, base64 encoded. Each evidence document must be placed on a separate page within the file. The original file must be in PDF format.
checksum
required

 string
Payment proof amount, SHA256 encrypted.
Request example 
{
  "request": {
    "skip_duplicate_check": false,
    "amount": 322400,
    "currency": "USD",
    "document": {
      "content_type": "application/pdf",
      "file_name": "3224.pdf",
      "file_size": 198149,
      "content": "cmVmCjE5Yzd2NwolJUVPRgo=",
      "checksum": "45EA3C910A727823079CF1E7DAB4B8BA"
    }
  }
}

Response

Response example 
{
    "transaction": {
        "proof": {
            "message": "Proof was successfully processed.",
            "ref_id": null,
            "gateway_id": 3440,
            "status": "failed"
        },
        "uid": "f4b1b969-566d-4967-9c29-b2214763fb6c",
        "status": "successful",
        "message": "Proof was successfully processed.",
        "amount": 71267,
        "parent_uid": "b498e245-b2d6-42e9-99d8-81cd8beb2b70",
        "currency": "USD",
        "type": "proof"
    }
}