Skip to main content
Reject Beneficiary
curl --request POST \
  --url https://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}/reject \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "meta": {
    "tracingId": "e7b7636d-a041-4013-8a1b-34dc85b7d341"
  },
  "data": {
    "beneficiaryId": "a5cc1d07-dd0b-469f-8ebd-f580e8314efd",
    "details": {
      "name": "Albert",
      "match": {
        "status": "NO_MATCH"
      },
      "accountIdentifier": {
        "type": "IBAN",
        "identification": "GB33BUKB2020155555555"
      }
    }
  }
}
'
{
  "meta": {
    "tracingId": "e7b7636d-a041-4013-8a1b-34dc85b7d341"
  },
  "data": {
    "beneficiaryId": "a5cc1d07-dd0b-469f-8ebd-f580e8314efd",
    "status": "REJECTED",
    "details": {
      "name": "Albert",
      "match": {
        "status": "NO_MATCH"
      },
      "accountIdentifier": {
        "type": "IBAN",
        "identification": "GB33BUKB2020155555555"
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Use HTTP Basic Authentication with your Application ID as username and Application Secret as password. Manage credentials in the Yapily Console. See Authentication for details.

Headers

sub-application
string<uuid>

The sub-application ID to which event type is being subscribed to

Path Parameters

beneficiaryId
string<uuid>
required

Beneficiary Id

Example:

"e7b7636d-a041-4013-8a1b-34dc85b7d341"

userId
string<uuid>
required
Example:

"e7b7636d-a041-4013-8a1b-34dc85b7d341"

Body

application/json

Beneficiary request with the details of the VoP result.

name
string
required

name of the beneficiary

Example:

"John Doe"

accountIdentifier
object
required

Account's details.

match
object

Details of the match given by the institution.

Response

OK.

The user beneficiary response.

meta
object
data
object

Beneficiary data response.