Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Current »

Use this method to receive a payment in Komet Sales.

Valid Tokens: Company.

This method does not return payments coming from the Clearent Integration.


Related Articles

Request


URL: https://api.kometsales.com/api/payment.receive

Method: POST

Content-Type: application/JSON


Input Parameters

authenticationToken (required)(string:50)

Komet Sales security token.


customerId (required)(integer:20)

Customer ID.

You can get this value from the customer.list API method.


locationCode (required)(string:20)

Company Location code.

Only applies to Multi-Location companies.

You can get this value from the location.list API method.


methodId (required)(integer:20)

Komet Sales internal Payment Method ID from the master list.

You can get this value from the payment.method.list API method.


date (required)(date)

Payment date.

Date format: YYYY-MM-DD


totalPayment (optional)(decimal:10,2)

Total payment amount.

The amount in this field must be equal to or greater than the total of every Invoice included in the request.

You can also use this field to create overpayments in the system by adding a higher total.


referenceNumber (optional)(string:100)

Check or reference number.


notes (optional)(string:200)

Payment notes.


invoices (required)

An array of Invoices that will receive payment.


invoiceNumber (required)(integer:10)

Invoice number.

You can get this value from the invoice.details.list API method.


amount (required)(decimal:10,2)

Amount to pay to this Invoice.


discount (optional)(decimal:10,2)

Discount to apply to the order.


{
"authenticationToken": "token_info_goes_here",
"customerId": 99999,
"totalPayment": 3000,
"methodId": "999", 
"date": "2014-06-10",
"referenceNumber": "Check 4566",
"notes": "Any special notes goes here", 
"invoices": 
[
{
"invoiceNumber": 9999, 
"amount": 1.200, 
"discount": 0
},
{ 
"invoiceNumber": 9998, 
"amount": 800, 
"discount": 100
}
]
}

Response


status (integer:1)

Transaction status.

Valid values: 1 = Success | 0 = Failure


message (string:500)

Transaction status description.


controlNumber (integer:20)

Payment control number.


{
  "status": "1",
  "message": "success",
  "controlNumber": "9999"
 }
We've encountered an issue exporting this macro. Please try exporting this page again later.
  • No labels