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.begateway.com/beyag/transactions/{uid}/proof

Parameter Type Description
request 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.
document 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"
    }
}