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"
}
}