| Modifier and Type | Interface and Description |
|---|---|
static class |
BankingPayeesAPI.ParamType |
| Modifier and Type | Method and Description |
|---|---|
ResponseBankingPayeeById |
getPayeeDetail(String payeeId,
String xV,
String xMinV,
String xFapiInteractionId,
String xFapiAuthDate,
String xFapiCustomerIpAddress,
String xCdsClientHeaders) |
ResponseBankingPayeeList |
listPayees(BankingPayeesAPI.ParamType type,
Integer page,
Integer pageSize,
String xV,
String xMinV,
String xFapiInteractionId,
String xFapiAuthDate,
String xFapiCustomerIpAddress,
String xCdsClientHeaders) |
@Endpoint(path="/banking/payees/{payeeId}", summary="Get Payee Detail", description="Obtain detailed information on a single payee. Note that the payee sub-structure should be selected to represent the payment destination only rather than any known characteristics of the payment recipient", requestMethod=GET, operationId="getPayeeDetail", responses=@EndpointResponse(responseCode=OK,description="Success",headers={@ResponseHeader(name="x-v",type="string",description="The [version](#response-headers) of the API end point that the data holder has responded with."),@ResponseHeader(name="x-fapi-interaction-id",type="string",description="An RFC4122 UID used as a correlation id. The data holder must set the response header x-fapi-interaction-id to the value received from the corresponding fapi client request header or to a new RFC4122 UUID value if the request header was not provided to track the interaction.")},content=ResponseBankingPayeeById.class)) @CustomAttribute(name="x-scopes",value="bank:payees:read",multiple=true) @CustomAttribute(name="x-version",value="1") ResponseBankingPayeeById getPayeeDetail(@Param(name="payeeId",description="The ID used to locate the details of a particular payee",in=PATH) @CDSDataType(value=ASCII) String payeeId, @Param(name="x-v",description="Version of the API end point requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between [x-min-v](#request-headers) and [x-v](#request-headers). If the value of [x-min-v](#request-headers) is equal to or higher than the value of [x-v](#request-headers) then the [x-min-v](#request-headers) header should be treated as absent. If all versions requested are not supported then the data holder should respond with a 406 Not Acceptable. See [HTTP Headers](#request-headers)",in=HEADER,reference="RequestHeader_x-v") String xV, @Param(name="x-min-v",description="Minimum version of the API end point requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between [x-min-v](#request-headers) and [x-v](#request-headers). If all versions requested are not supported then the data holder should respond with a 406 Not Acceptable.",in=HEADER,reference="RequestHeader_x-min-v") String xMinV, @Param(name="x-fapi-interaction-id",description="An [RFC4122](https://tools.ietf.org/html/rfc4122) UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a [RFC4122] UUID value is required to be provided in the response header to track the interaction.",in=HEADER,reference="RequestHeader_x-fapi-interaction-id") String xFapiInteractionId, @Param(name="x-fapi-auth-date",description="The time when the customer last logged in to the data recipient. Required for all resource calls (customer present and unattended). Not to be included for unauthenticated calls.",in=HEADER,reference="RequestHeader_x-fapi-auth-date") String xFapiAuthDate, @Param(name="x-fapi-customer-ip-address",description="The customer\'s original IP address if the customer is currently logged in to the data recipient. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.",in=HEADER,reference="RequestHeader_x-fapi-customer-ip-address") String xFapiCustomerIpAddress, @Param(name="x-cds-client-headers",description="The customer\'s original standard http headers [Base64](#common-field-types) encoded, including the original User Agent header, if the customer is currently logged in to the data recipient. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.",in=HEADER,reference="RequestHeader_x-cds-client-headers") @CDSDataType(value=Base64) String xCdsClientHeaders)
@Endpoint(path="/banking/payees", summary="Get Payees", description="Obtain a list of pre-registered payees", requestMethod=GET, operationId="listPayees", responses=@EndpointResponse(responseCode=OK,description="Success",headers={@ResponseHeader(name="x-v",type="string",description="The [version](#response-headers) of the API end point that the data holder has responded with."),@ResponseHeader(name="x-fapi-interaction-id",type="string",description="An RFC4122 UID used as a correlation id. The data holder must set the response header x-fapi-interaction-id to the value received from the corresponding fapi client request header or to a new RFC4122 UUID value if the request header was not provided to track the interaction.")},content=ResponseBankingPayeeList.class)) @CustomAttribute(name="x-scopes",value="bank:payees:read",multiple=true) @CustomAttribute(name="x-version",value="1") ResponseBankingPayeeList listPayees(@Param(name="type",description="Filter on the payee type field. In addition to normal type field values, ALL can be specified to retrieve all payees. If absent the assumed value is ALL",in=QUERY,defaultValue="ALL") BankingPayeesAPI.ParamType type, @Param(name="page",description="Page of results to request (standard pagination)",in=QUERY,defaultValue="1",reference="ParamPage") @CDSDataType(value=PositiveInteger) Integer page, @Param(name="page-size",description="Page size to request. Default is 25 (standard pagination)",in=QUERY,defaultValue="25",reference="ParamPageSize") @CDSDataType(value=PositiveInteger) Integer pageSize, @Param(name="x-v",description="Version of the API end point requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between [x-min-v](#request-headers) and [x-v](#request-headers). If the value of [x-min-v](#request-headers) is equal to or higher than the value of [x-v](#request-headers) then the [x-min-v](#request-headers) header should be treated as absent. If all versions requested are not supported then the data holder should respond with a 406 Not Acceptable. See [HTTP Headers](#request-headers)",in=HEADER,reference="RequestHeader_x-v") String xV, @Param(name="x-min-v",description="Minimum version of the API end point requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between [x-min-v](#request-headers) and [x-v](#request-headers). If all versions requested are not supported then the data holder should respond with a 406 Not Acceptable.",in=HEADER,reference="RequestHeader_x-min-v") String xMinV, @Param(name="x-fapi-interaction-id",description="An [RFC4122](https://tools.ietf.org/html/rfc4122) UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a [RFC4122] UUID value is required to be provided in the response header to track the interaction.",in=HEADER,reference="RequestHeader_x-fapi-interaction-id") String xFapiInteractionId, @Param(name="x-fapi-auth-date",description="The time when the customer last logged in to the data recipient. Required for all resource calls (customer present and unattended). Not to be included for unauthenticated calls.",in=HEADER,reference="RequestHeader_x-fapi-auth-date") String xFapiAuthDate, @Param(name="x-fapi-customer-ip-address",description="The customer\'s original IP address if the customer is currently logged in to the data recipient. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.",in=HEADER,reference="RequestHeader_x-fapi-customer-ip-address") String xFapiCustomerIpAddress, @Param(name="x-cds-client-headers",description="The customer\'s original standard http headers [Base64](#common-field-types) encoded, including the original User Agent header, if the customer is currently logged in to the data recipient. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.",in=HEADER,reference="RequestHeader_x-cds-client-headers") @CDSDataType(value=Base64) String xCdsClientHeaders)
Copyright © 2020. All rights reserved.