Approve a pending approval association

patch/scaAssociations

API Version

Approves a previously created association that is in a pending state.

Endpoint destination URL

https://balanceplatform-api-test.adyen.com/bcl/v2/scaAssociations

Header Parameters

Required

Optional

Min length: 1Max length: 10000

The header for authenticating through SCA.

Request Parameters

Required

Optional

Min length: 1Max length: 100

The unique identifier of the entity.

The type of the entity.

Possible values: accountHolder or paymentInstrument.

List of device ids associated to the entity that will be approved.

The status of the association.

Possible values: active or pendingApproval.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

200 - OK
Successful approval
scaAssociationsarray[object]
The list of associations.
entityIdstring
Min length: 1Max length: 100
The unique identifier of the entity.
entityTypestring
The type of entity you are associating the device with.

Possible values: accountHolder or paymentInstrument.
scaDeviceIdstring
Min length: 30Max length: 30
The unique identifier for the SCA device.
statusstring
The status of the association.

Possible values: active or pendingApproval.
401 - Unauthorized
Authentication required.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
namestring
The field that has an invalid value.
valuestring
The invalid value.
messagestring
Description of the validation error.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
403 - Forbidden
Insufficient permissions to process the request.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
namestring
The field that has an invalid value.
valuestring
The invalid value.
messagestring
Description of the validation error.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
500 - Internal Server Error
The server could not process the request.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
namestring
The field that has an invalid value.
valuestring
The invalid value.
messagestring
Description of the validation error.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.

Approve a pending approval association

HTTP Responses

200 - OK

401 - Unauthorized

403 - Forbidden

500 - Internal Server Error