ZEzeptopayments
Agreements

list agreements

get/payto/agreements

Request

  • Base URL
    https://api.sandbox.zeptopayments.com
  • URL
    https://api.sandbox.zeptopayments.com/payto/agreements
  • Auth
    HTTP bearer

Query parameters

per_pageinteger

Number of results per page

starting_afterstring

Opaque pagination cursor value. Set by following "next" links.

statestring[]

Filter agreements by state. Multiple values can be separated by commas.

initiator_namestring

Filter agreements by initiator name. The filtering is case sensitive and must be an exact match.

initiator_client_idstring uuid

Filter agreements initiated by the client. Accepts the client_id supplied via initiator.client_id when the agreement was created. Only agreements created with the supplied initiator.client_id are matched.

min_created_datestring date

Filter by minimum created_at date. ISO8601 format.

max_created_datestring date

Filter by maximum created_at date. ISO8601 format.

Response

successful

Example response

{
  "data": [
    {
      "uid": "biz_agreement_G7MQWwkQZIP8vbfH",
      "created_at": "2022-01-20T12:34:56+11:00",
      "mms_agreement_id": "3de455278b21196da0c4599025cb7dfa",
      "links": {
        "self": "https://api.zeptopayments.com/payto/agreements/biz_agreement_G7MQWwkQZIP8vbfH"
      },
      "description": "Payment plan for loan #1234",
      "purpose": "loan",
      "resolution_requested_before": "2022-01-20T12:34:56Z",
      "cancel_if_unresolved": true,
      "payment_terms": {
        "type": "fixed",
        "frequency": "monthly",
        "count": 1,
        "amount": 10000,
        "max_amount": 100000,
        "first_payment_amount": 100000,
        "last_payment_amount": 100000,
        "first_payment_date": "2023-12-31",
        "last_payment_date": "2024-12-31"
      },
      "debtor": {
        "ultimate_party_name": "Billie Jean Senior",
        "party_name": "Billie Jean Junior",
        "account_identifier": {
          "value": "123456-98765432"
        },
        "payment_account_uid": "pa_20221231_G7MQWwkQZIP8vbfH"
      },
      "creditor": {
        "ultimate_party_name": "Billie Jean Senior",
        "party_name": "Billie Jean Junior",
        "account_identifier": {
          "value": "123456-98765432"
        },
        "payment_account_uid": "pa_20221231_G7MQWwkQZIP8vbfH"
      },
      "initiator": {
        "client_id": "b792ca63-b394-4eb2-937b-a5e5e12c77d1",
        "name": "Jane's Flowers",
        "legal_name": "Blossoming Flowers Pty Ltd",
        "abn": "56192755287",
        "acn": "192755287"
      },
      "validity_start_date": "2023-01-01",
      "validity_end_date": "2023-12-31",
      "state_reason": {
        "title": "Agreement Status Invalid",
        "detail": "Contact Zepto for more information - The requested operation cannot be performed for the current status of the agreement",
        "code": "MMS.API.9104"
      },
      "metadata": {
        "custom_key": "custom_value"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.