Create a payment record for a specific account

POST /accounts/{account_id}/line_items/payments/payment_record

Canopy will simply record the payment details in the system of record without attempting to leverage the payment processing configuration to initiate the actual transaction.

Path parameters

Body Required

Body of request to create payment.

  • line_item_id string Required

    The ID to be associated with the line item for future requests.

    Format should match the following pattern: ^(?!can_).*$.

  • original_amount_cents integer Required

    The payment amount in cents.

    Default value is 0.

  • The new status which you would like to set for the line item

    Values are VALID, INVALID, PENDING, or AUTHORIZED. Default value is VALID.

  • effective_at string(date-time)

    The Date-Time that the payment is applicable to the account. Although the payment is created in Canopy today, it can actually be effective 10 days prior.

  • external_fields array[object] | null

    External fields can be used to relate payments created in Canopy to entities in your or any external system.

    Not more than 10 elements.

    Hide external_fields attributes Show external_fields attributes array[object] | null
    • key string

      Key - i.e. Name of the External Party

    • value string

      Value - i.e. External Account ID

Responses

  • Payment created

    Hide response attributes Show response attributes object
    • account_id string Required

      The account associated with the line item

    • line_item_id string Required

      The ID associated with the line item

    • effective_at string(date-time)

      The Date-Time that this line item became/becomes active

    • created_at string(date-time)

      The Date-Time which the line item was created.

    • product_id string Required

      the Product ID of the account

    • Hide line_item_summary attributes Show line_item_summary attributes object
      • The originating amount of money (in cents) relating to this line item.

      • The current balance of the line item, which accounts for interest accrued per the product's interest policy and the account's interest rate attribute.

      • The principal balance of the line item.

      • The current interest balance of the line item.

      • The current AM interest balance of the line item. Canopy tracks interest during an amortization period separately from deferred interest accrued during a revolving period.

      • The current deferred interest balance of the line item.

      • The current AM deferred interest balance of the line item. Canopy tracks deferred interest during an amortization period separately from deferred interest accrued during a revolving period.

      • The sum (in cents) of all payments towards interest charges, if any, applied to this line item to date

    • merchant_data object | null

      Merchant information if applicable.

      Hide merchant_data attributes Show merchant_data attributes object | null
    • Hide issuer_processor_details attribute Show issuer_processor_details attribute object | null
      • lithic object
        Hide lithic attributes Show lithic attributes object
        • last_four string | null

          Last four digits of the card against which the spend was made.

        • transaction_token string(uuid) | null

          The external unique identifier of the transaction.

        • card_token string(uuid) | null

          The external unique identifier of the card related to this line item.

    • external_fields array[object] | null

      An array of static references to fields in a third party system.

      Not more than 1000 elements.

      Hide external_fields attributes Show external_fields attributes array[object] | null
      • key string

        Key - i.e. Name of the External Party

      • value string

        Value - i.e. External Account ID

    • Hide line_item_overview attributes Show line_item_overview attributes object
      • The new status which you would like to set for the line item

        Values are VALID, INVALID, PENDING, or AUTHORIZED. Default value is VALID.

      • line_item_type string Required

        The line item type PAYMENT

        Default value is PAYMENT.

      • description string | null

        A description of this particular line item if any. More common for adjustments.

  • Unauthorized.

  • Forbidden.

  • Invalid input

  • Too many requests.

  • Unexpected Error.

POST /accounts/{account_id}/line_items/payments/payment_record
curl \
 -X POST https://sandbox-api.canopyservicing.com/accounts/31mNprzLd2bKl6koVna68ARM/line_items/payments/payment_record \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"line_item_id":"0x1234","original_amount_cents":200,"line_item_status":"VALID","effective_at":"2020-07-20T09:11:28+00:00","external_fields":[{"key":"Globex Card Processing Account ID","value":"22445702-a389-431f-927d-07b8d0750787"}]}'
Request example
{
  "line_item_id": "0x1234",
  "original_amount_cents": 200,
  "line_item_status": "VALID",
  "effective_at": "2020-07-20T09:11:28+00:00",
  "external_fields": [
    {
      "key": "Globex Card Processing Account ID",
      "value": "22445702-a389-431f-927d-07b8d0750787"
    }
  ]
}
Request examples
{
  "line_item_id": "0x1234",
  "original_amount_cents": 200,
  "line_item_status": "VALID",
  "effective_at": "2020-07-20T09:11:28+00:00",
  "external_fields": [
    {
      "key": "Globex Card Processing Account ID",
      "value": "22445702-a389-431f-927d-07b8d0750787"
    }
  ]
}
Response examples (200)
{
  "account_id": 4,
  "line_item_id": 2,
  "effective_at": "2018-07-20T09:12:30+00:00",
  "created_at": "2018-06-20T09:12:30+00:00",
  "product_id": 1,
  "line_item_summary": {
    "original_amount_cents": 2484,
    "balance_cents": 3600,
    "principal_cents": 2400,
    "interest_balance_cents": 1100,
    "am_interest_balance_cents": 0,
    "deferred_interest_balance_cents": 200,
    "am_deferred_interest_balance_cents": 0,
    "total_interest_paid_to_date_cents": -16
  },
  "merchant_data": {
    "name": "string",
    "id": "string",
    "mcc_code": 42.0,
    "phone_number": "string"
  },
  "issuer_processor_details": {
    "lithic": {
      "last_four": 3324,
      "transaction_token": "33xd08bc-d100-488y-bb93-f8a1f081ff0e",
      "card_token": "c6cd08bc-c524-48f5-b64d-f79ec0810df4"
    }
  },
  "external_fields": [
    {
      "key": "Globex Card Processing Account ID",
      "value": "22445702-a389-431f-927d-07b8d0750787"
    }
  ],
  "line_item_overview": {
    "line_item_status": "VALID",
    "line_item_type": "PAYMENT",
    "description": "Payment against the account"
  }
}
Response examples (200)
{
  "account_id": 4,
  "line_item_id": 2,
  "effective_at": "2018-07-20T09:12:30+00:00",
  "created_at": "2018-06-20T09:12:30+00:00",
  "product_id": 1,
  "line_item_summary": {
    "original_amount_cents": 2484,
    "balance_cents": 3600,
    "principal_cents": 2400,
    "interest_balance_cents": 1100,
    "am_interest_balance_cents": 0,
    "deferred_interest_balance_cents": 200,
    "am_deferred_interest_balance_cents": 0,
    "total_interest_paid_to_date_cents": -16
  },
  "merchant_data": {
    "name": "string",
    "id": "string",
    "mcc_code": 42.0,
    "phone_number": "string"
  },
  "issuer_processor_details": {
    "lithic": {
      "last_four": 3324,
      "transaction_token": "33xd08bc-d100-488y-bb93-f8a1f081ff0e",
      "card_token": "c6cd08bc-c524-48f5-b64d-f79ec0810df4"
    }
  },
  "external_fields": [
    {
      "key": "Globex Card Processing Account ID",
      "value": "22445702-a389-431f-927d-07b8d0750787"
    }
  ],
  "line_item_overview": {
    "line_item_status": "VALID",
    "line_item_type": "PAYMENT",
    "description": "Payment against the account"
  }
}