Add Bank Receipts / Payments

API Version: v1.1

These are direct bank payments and receipts.

Business Rules

The followings are required fields in the bank payment.

•	Payment Type (Bank Payment (“EP”) / Bank Receipt(“IR”))
•	Payment Date
•	Bank Code
•	Nominal Code
•	Amount

In case of multiple payments, maximum of 50 payments are allowed in one API call.

The Payment Object
ApiToken

String

*(Required)

API authorisation token obtained via authentication API.
PaymentType

Enum

*(Required)

Payment Type ('EP', 'IR'), Bank Payment: 'EP', Bank Receipts: 'IR'
BankCode

String(20)

*(Required)

Bank Account Code is defined in the Chart of Accounts.
CurrencyCode

String (5)

*(Optional)

This is required when a foreign currency transaction is recorded. Currency code for the Bank Account, e.g. PKR or USD. The Currency Codes can be found in the Currencies List. When omitted, the transaction is treated as linked to the Company’s base currency.
ExchangeRate

Decimal (15, 8)

*(Optional)

The exchange rate for foreign currency transactions. Base Currency to Foreign Currency. Must be provided when a foreign currency transaction is recorded.
API Object
PaymentDate

Date (YYYY-MM-DD)

*(Required)

Payment date refers to the date on which the payment is made.
NominalCode

String (20)

*(Required)

Nominal Account Code from the Chart of Account.
Amount

decimal (15, 2)

*(Required)

The total amount paid in the relevant currency e.g. for a USD bank payment, the amount will be USD amount.
RefNo

String (100)

(Optional)

It is a reference number for the payment.
Mode

Enum

(Optional)

Payment Mode ('Cash', 'Cheque', 'Credit Card', 'Offset', 'Online', 'Pay Order').
Details

String (500)

(Optional)

The details for the bank payment.
ProjectCode

String (50)

(Optional)

Project Code linked with the project. Refer to the Projects list.
Sample Object
{
    "ApiToken": "13462d81b1547902cd0644c22f6900df",
    "PaymentType":"EP",
    "BankCode":"230903",
    "CurrencyCode":"PKR",
    "ExchangeRate":"1",
    "Receipts": [
        {
            	"PaymentDate": "2021-10-11",
"NominalCode": "710604",       
            	"Amount":"100.05",
"RefNo": "1",
            	"Mode": "Cash",
             "Details": "Notes 1",
            	"ProjectCode": "PJ101"
        },
         {
            "PaymentDate": "2021-10-12",
"NominalCode": "710607",
            "Amount":"110.15",
            "RefNo": "2",
            "Mode": "Online",
            "Details": "Notes 2",
            "ProjectCode": "PJ102"           
        }
    ]
}
API URL

https://api.fastaccounts.io/index.php/api/bank/payments_receipts

Sample Response
{"Status":1,"Code":"200","Message":"The request was successfully completed.","VoucherID":"6"}
Status Codes
Status Code Type Message
200 Success The request was successfully completed.
201 Error Invalid Key Details.
202 Error Data is not valid in API request.
203 Error Data is not valid in API products.
204 Error Validation failed.
205 Error Invalid IP Address.
400 Error Bad Request.
403 Error Forbidden.
404 Error Not Found.
500 Error Internal Server Error.