The fields and formats needed for the Cancellation conversation are listed in this section.
Brokers have a way to modify a customer's telephone information with the Cancellation request. The request is verified, and any inaccuracies are returned for correction.


Request example

    "clientCode": "CC",
    "shopCode": "XXXX",
        "brokerReference": "3607/015",
        "accountNumber": "910000016987",

Response example

    "data": {
        "cancellationResponseType": {
            "responseStatus": 1,
            "responseStatusText": "Success"
        "errors": null
    "validationErrors": [],
    "error": -1,
    "error_description": null,
    "successful": true



NodeRequiredTypeMax LengthNotes
BrokerReferenceMandatoryString25This is a unique reference provided by the broker to identify the applicant.
The broker can use this reference to identify and locate the applicant on the BNPP PF system.
AccountNumberMandatoryString15This is the reference BNPP PF has assigned to the applicant as part of the new application process. It is used to locate the account and apply the transaction.
It is mandatory to provide the AccountNumber and BrokerReference for Cancellations.
ReturnOfPremiumValueMandatoryDecimalThis is the amount (of the premium) that is returned in a cancellation, e.g. £139.67.
CancellationReasonTypeMandatoryString2This is the reason for the cancellation. See CancellationReasonType in Node Options
PolicyCancellationDateMandatoryDateThis is the date the policy was cancelled.
Mandatory if
CancellationReasonType is 2,
Optional if CancellationReasonType is 1,3,7
InsurerReturnOfPremiumV alueMandatoryDecimalThis is the full return of premium amount as provided by the insurer, e.g. £150.00.
RopDeductionAmountMandatoryDecimalThis is the amount of premium retained, e.g. £20.00.


NodeRequiredTypeMax LengthNotes
ResponseStatusMandatoryEnumThis is the status of a response See ResponseStatus in Option Values