Tango AP Inbound (Payment Confirmation) API
Generated fromTango AP Inbound API Integration Design Specification V1.2.docxin SharePoint folder02 Lease Integrations.
Overview
Async REST API for posting AP check confirmations back to Tango after the client issues lease payments. Tango updates the Payments tab; payment status transitions toPAID or VOID.
Owner: Tango Analytics
Spec version: 1.2
Status: Draft (auto-generated — needs review)
Base URLs
Authentication
Headersx-client + x-api-key, required on every call.
Endpoints
PUT /v1/leasemgmt/payments
GET /v1/batch/status?gu_id=...
Three response shapes (PROCESSING / COMPLETED / ERROR). On error, record_key is lease_payment_id; multiple errors for the same record are returned comma-separated.
Integration logic
lease_payment_idis the record key — must already exist in Tango (it’s the same ID Tango sent in AP Outbound).- Check Amount and Applied Amount may differ.
- A payment can be
VOIDeither before the check is issued OR after it wasPAID(retraction). - Alternatively, the business may keep history by creating a credit invoice manually and marking the original payment
VOID.
Data model
Validations
invoice_header_idis NULL →Invoice_header_id is nulllease_payment_iddoes not exist →lease_payment_id does not exist in Tangopayment_statusis NULL →payment_status is nullpayment_statusnot in (PAID,VOID) →payment_status does not match expected valuecheck_numberis NULL →check_number is nullcheck_dateis NULL →check_date is nullcheck_dateformat notMM/DD/YYYY→check_date does not match expected format
Open Questions / Assumptions
- Sample JSON sends numeric fields as strings (
"check_amount": "309.00"). Schema usesnumber; consumers may need to coerce. - No explicit response for synchronous errors at PUT — assumed errors flow through the polled status response.
- Lookup codes for payment statuses, etc., are
<TBD>in source Appendix.

