Payment capture

API endpoint (POST)
https://api.maibmerchants.md/v1/complete

Request parameters (body)

Parameter	Required	Type	Description
payId	YES	String	The identifier of the transaction that has been authorized and must be completed.
confirmAmount	NO	Number (decimal)	Amount to be debited from Customer's bank account. Format: X.XX E.g: 10.25 (currency=USD) means $10 and 25 cents. It can be less than or equal to the amount that was previously put on hold. If this parameter is not present, the entire previously put on hold amount will be debited.

Example

{
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"confirmAmount": 10.25
}

Response parameters

Parameter	Type	Description
result	Object	Object containing transaction data.
payId	String	Transaction identifier assigned by maib ecomm.
orderId	String	Order ID generated by Merchant website/app.
status	String	Transaction status OK - successfully completed.
statusCode	String	Transaction status code
statusMessage	String	Transaction status information message
rrn	String	RRN - Transaction ID generated by maib ecomm.
approval	String	Approval Code - The transaction approval code generated by the card issuing bank.
cardNumber	String	Masked number card.
confirmAmount	Number (decimal)	Amount debited from Customer's bank account. Format: X.XX
ok	Boolean	Request/transaction processing status: true - no errors; false - an error occurred (error details will be in errors);
errors	Array	Request/transaction processing errors. Errors table
errorCode	String	Error code
errorMessage	String	Error description
errorArgs	Object	Object contains parameters with error details

Example

Successful

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"confirmAmount": 10.25
},
"ok": true
}

Error

{
    "errors": [
        {
            "errorCode": "12001",
            "errorMessage": "Parameter 'confirmAmount' is invalid",
            "errorArgs": {
                "parameter": "confirmAmount"
            }
        }
    ],
    "ok": false
}