Commit Payment

Processes and commits citizen payment information for the specified payment transaction ID. The Commit Payment API allows a third-party payment vendor to send payment information to Automation. The Commit Payment API processes the payment information, logs merchant account audit information, triggers the EMSE events ConvertToRealCAPBefore and PaymentReceiveBefore, creates a transaction record, triggers the EMSE event ConvertToRealCAPAfter, finishes the Automation payment, triggers the EMSE event PaymentReceiveAfter, and appoves the transaction.

Note: An agency Construct administrator controls which apps can call Commit Payment. By default, Commit Payment is disabled. To allow an app to call Commit Payment, an agency administrator must go to the {Agency}:Apps page on the Construct Admin Portal, and enable the Payment Enabled property for the app.

Resource Information

Scopepayments

Deprecated scope name:   confirm_payment

App TypeCitizen
Authorization TypeAccess token
URI /V4/payments/{id}?fields={fields}&lang={lang}
HTTP MethodPUT
Automation Version(s)7.3.3.4

Request Information

Field or ParameterTypeRequiredValuesDescriptionAutomation Version
amountdoubleYes The payment amount.7.3.3.4
commentsstringNo Comments related to the payment transaction.7.3.3.4
convenienceFeedoubleYes The payment convenience fee to be applied. Set to 0 if none.7.3.3.4
creditCardcreditCard{}No The credit card information.7.3.3.4
creditCard.billingAddresscreditCard.billingAddress{}No The credit card address.7.3.3.4
creditCard.billingAddress.addressLine1stringNo The first line of the address. 7.3.3.4
creditCard.billingAddress.addressLine2stringNo The second line of the address.7.3.3.4
creditCard.billingAddress.addressLine3stringNo Get All Address Unit Types The current status of the address record.7.3.3.4
creditCard.billingAddress.citystringNo The name of the city.7.3.3.4
creditCard.billingAddress.countryCodestringNo Get All Address Countries The name of the country. Required if billing address is provided.7.3.3.4
creditCard.billingAddress.postalCodestringNo The name of the county.7.3.3.4
creditCard.billingAddress.statestringNo Get All Address States The state corresponding to the address on record.7.3.3.4
creditCard.businessNamestringNo A secondary business name for the applicable individual.7.3.3.4
creditCard.cardNumberLastDigitsstringNo The last 4 digits of the credit card number.7.3.3.4
creditCard.cardTypestringYes The credit card type. For example, Visa, American Express, or Discover.7.3.3.4
creditCard.holderNamestringNo The check holder's name.7.3.3.4
merchantAccountIdstringNo The account ID of the merchant receiving the payment.7.3.3.4
payeePhonestringNo The area code and phone number of the payee.7.3.3.4
paymentMethodstringYesCredit Card | CheckThe method of payment, either Credit Card or Check.7.3.3.4
paymentSystemTransactionIdstringYes The third party payment system's payment transaction ID.7.3.3.4
fieldsstringNo Comma-delimited names of fields to be returned in the response. Note: Field names are case-sensitive and only first-level fields are supported. Invalid field names are ignored.7.3.3.4
idstringYes The unique identifier for the object, assigned by the Civic Platform server and provided in a response.7.3.3.4
langStringNo Indicates the language applied.7.3.3.4

Example

Sample Request Head

PUT  https://apis.accela.com/v4/payments/322931

Sample Request Body

{
  "amount": "100.50",
  "convenienceFee": "0",
  "payeePhone": "4067615677",
  "paymentMethod": "Credit Card",
  "paymentSystemTransactionId": "d1f63549-8fd1-4be5-abf8-e624897044be",
  "creditCard": {
    "cardType": "VISA",
    "cardNumberLastDigits": "*4219",
    "holderName": "Jane Johnston"
  }
}

Notes

This example commits payment information for a third-party payment transaction id #322931.

Response Information

FieldTypeDescriptionAutomation Version
resultresult{} 7.3.3.4
result.completePaymentsresult.completePayments{}An array containing the completed payment transaction.7.3.3.5.0
result.completePayments.paymentIdstringThe payment id.7.3.3.5.0
result.completePayments.paymentStatusstringThe payment status (currently, this field always returns "PAID").7.3.3.5.0
result.completePayments.receiptIdstringThe payment receipt id.7.3.3.5.0
result.completePayments.recordIdresult.completePayments.recordId{}The record id the payment is applied to.7.3.3.5.0
result.completePayments.serviceProviderCodestringThe unique agency identifier.7.3.3.5.0
result.messagestringResponse message for the payment transaction.7.3.3.4
statusintegerThe record status.7.3.3.4

Example

Sample Response Body

{
  "result": {
    "completePayments": [
      {
        "receiptId": "198284",
        "serviceProviderCode": "TACOMA",
        "recordId": "TACOMA-03HST-00000-002UD",
        "customId": "BLD2003-01115",
        "paymentId": 3166539,
        "paymentStatus": "Paid"
      }
    ]
  },
  "status": 200
}