v1

latestOpenAPI 3.1.02026-07-2469193340.0 KB

CoP Account Validations

account name validation

Validates a given name matches a given account.

post/cop/account/validate

Request body

uidstring required

Supplied unique identifier for CoP lookup, maximum 64 characters containing only unreserved characters as defined in RFC3986. This identifier ensures CoP lookup uniqueness between integrator systems and Zepto.

party_namestring required

The party name to validate against the account

Example request

{
  "uid": "biz_cop_request_123456",
  "account_identifier": {
    "type": "bban",
    "value": "062000-11111111"
  },
  "party_name": "John Doe",
  "requester": {
    "id": "AdminUser1234"
  },
  "sandbox": {
    "simulate": "match"
  }
}

Response

Example response

{
  "data": {
    "outcome": {
      "result": "match",
      "match_name": "John Doe and others",
      "message": "The account is in the name of John Doe and others"
    },
    "insights": {
      "risk_score": 25,
      "is_joint": true,
      "suggested_payment_channels": [
        "npp.sct",
        "de.dc"
      ]
    },
    "uid": "biz_cop_request_123456"
  }
}