{
   "id":{VALUE},
   "idempotency_key":{VALUE},
   "sent_at":{VALUE},
   "client":{ 
		"id":{VALUE} 
	},
   "events":[
        {
            "id":{VALUE},
            "event_id":{VALUE},
            "legacy_id":{VALUE},
            "created_at":{VALUE},
            "collection_date":{VALUE},
            "currency_code":{VALUE},
            "amount":{VALUE},
            "payment_type":{VALUE},         
            "status":{VALUE},         
            "edited_at":{VALUE},
            "represented_collection_date":{VALUE},
            "custom_reference":{VALUE},
            "event_source":{VALUE},
            "record_type":{VALUE},
            "description":{VALUE},
            "event_type":{VALUE},
            "direct_debit":{VALUE},
            "metadata":{VALUE},
            "client":{
                "id":{VALUE}
            },
            "created_by":{
                "id":{VALUE}
            },
            "edited_by":{
                "id":{VALUE}
            },  
            "customer_account":{
                "id":{VALUE},
                "legacy_id":{VALUE}
            },
            "recurrence_schedule":{
                "id":{VALUE},
                "legacy_id":{VALUE}
            },
            "related_payment":{
                "id":{VALUE},
                "legacy_id":{VALUE}
            },
            "card_payment":{
                "status_details":{VALUE},
                "status_code":{VALUE},
                "internal_payment_description":{VALUE},
                "gateway_payment_description":{VALUE},
                "authorisation_code":{VALUE},
                "transaction_id":{VALUE},
                "order_id":{VALUE},
                "charge_id":{VALUE},
                "metadata":{VALUE},
                "gateway_status":{VALUE},
                "gateway_status_code":{VALUE},
                "gateway_status_details":{VALUE},
                "card"{
                    "id":{VALUE},
                    "legacy_id":{VALUE}
                }
            }
        }
   ]
}

Note: Property display order for documentation purposes, actual order may vary.

Event Fields

Property Format Description
amount integer The amount of the payment in pence
card_payment Object or null Object containing the card_payment information. See below
client Object Object containing the client information. See below
collection_date date (YYYY-MM-DD) The Collection Date of the Payment
created_at datetime (ISO8601) Date and time the record was created
created_by Object or null Object containing the created_by information, if set. See below
currency_code string (ISO4217) ISO 4217 representation of the currency used for the payment
custom_reference string or null The Custom reference, if set
customer_account object or null Object containing Customer Account information, if set. See below
description string The Payments description
direct_debit null null - Not applicable to Card Payment Events
edited_at datetime (ISO8601) Date and time the record was edited
edited_by object or null Object containing the created_by information, if set. See below
event_id string The ID of the Event
event_source string The Source that triggered the event
event_type string This will be “payment.create” or “payment.update”
id string The ID of the Record
legacy_id string or null Legacy ID of the record, if set
metadata string or null String used to store custom metadata, if set
mandate null null - Not applicable to Card Payment Events
payment_type string The payment type of the record. See “Property Options” below
record_type string The record type of the Payment. See “Property Options” below
recurrence_schedule Object or null Object containing the recurrence_schedule information, if set. See below
related_payment Object or null Object containing the related_payment information, if set. See below
represented_collection_date date (YYYY-MM-DD) Date the represented was collected, if set
status string The Status of the Payment. See “Property Options” below

client Object Fields

Property Format Description
id string ID of the record

created_by Object Fields

Property Format Description
id string ID of the record

customer_account Object Fields

Property Format Description
id string ID of the record
legacy_id string or null Legacy ID of the record, if set

edited_by Object Fields

Property Format Description
id string ID of the record

recurrence_schedule Object Fields

Property Format Description
id string The ID of the Record
legacy_id string Legacy ID of the record, if set
Property Format Description
id string The ID of the Record
legacy_id string Legacy ID of the record, if set

card_payment Object Fields

Property Format Description
authorisation_code string or null Payment Authorisation code, if set
card object Object containing the card information. See below
charge_id string or null Charge ID, if set
gateway_payment_description string or null Gateway payment description, if set
gateway_status string or null The status of the card passed by the gateway to SmarterPay, if set
gateway_status_code string or null A code that the gateway may pass to SmarterPay to further describe the status, if set
gateway_status_details string or null Additional information, based on the status, passed by the gateway to SmarterPay, if set
internal_payment_description string or null Internal payment description, if set
metadata string or null Additional client JSON initially passed in the card registration request, if set
order_id string or null Order ID, if set
status_code string or null SmarterPay's normalised status code of the card, if set
status_details string or null SmarterPay's additional information based on the status, if set
transaction_id string or null Payment Transaction ID, if set

card Object Fields

Property Format Description
id string ID of the record
legacy_id string or null Legacy ID of the record, if set
{
    "id":{VALUE},
    "idempotency_key":{VALUE},
    "sent_at":{VALUE},
    "client":{ 
		"id":{VALUE} 
	},
    "events":[
        {
            "id":{VALUE},
            "legacy_id":{VALUE},
            "created_at":{VALUE},
            "collection_date":{VALUE},
            "currency_code":{VALUE},
            "amount":{VALUE},
            "payment_type":{VALUE},          
            "status":{VALUE},            
            "edited_at":{VALUE},
            "represented_collection_date":{VALUE},
            "custom_reference":{VALUE},          
            "event_source":{VALUE},
            "record_type":{VALUE},
            "description":{VALUE},
            "event_type":{VALUE},
            "metadata":{VALUE},         
            "client":{
                "id":{VALUE}
            },
            "created_by":{
                "id":{VALUE}
            },
            "edited_by":{
                "id":{VALUE}
            },  
            "customer_account":{
                "id":{VALUE},
                "legacy_id":{VALUE}
            },
            "recurrence_schedule":{
                "id":{VALUE},
                "legacy_id":{VALUE}
            },
            "related_payment":{
                "id":{VALUE},
                "legacy_id":{VALUE}
            },
            "direct_debit":{
                "bacs_reference":{VALUE},
                "bacs_filename":{VALUE},
                "bacs_reason_code":{VALUE},
                "bacs_description":{VALUE},
                "overriding_name":{VALUE},
                "default_narrative":{VALUE},
                "users_reference":{VALUE},
                "originating_bank_account":{
                    "id":{VALUE},
                    "legacy_id":{VALUE},
                    "account_name":{VALUE},
                    "account_number":{VALUE},
                    "sort_code":{VALUE}
                },
                "service_user_number":{
                    "id":{VALUE},
                    "sun_name":{VALUE},
                    "sun_number":{VALUE}
                },
                "mandate":{
                    "id":{VALUE},
                    "auddis":{VALUE}
                }                
            },          
            "card_payment":{VALUE}
        }
    ]
 }

Note: Property display order for documentation purposes, actual order may vary.

Event Fields

Property Format Description
amount integer The amount of the payment in pence
card_payment null null - Not applicable to Direct Debit Payment Events
client Object Object containing the client information. See below
collection_date date (YYYY-MM-DD) The Collection Date of the Payment
created_at datetime (ISO8601) Date and time the record was created
created_by Object or null Object containing the created_by information, if set. See below
custom_reference string or null The Custom reference,if set
customer_account object or null Object containing Customer Account information, if set. See below
description string The Payments description
direct_debit Object Object containing the direct_debit information. See below
edited_at datetime (ISO8601) Date and time the record was edited
edited_by object or null Object containing the created_by information, if set. See below
event_source string The Source that triggered the event
event_type string This will be “payment.create” or “payment.update”
id string The ID of the Record
legacy_id string or null Legacy ID of the record, if set
metadata string or null String used to store custom metadata, if set
mandate Object or null Object containing the mandate information, if set. See below
payment_type string The payment type of the record. See “Property Options” below
record_type string The record type of the Payment. See “Property Options” below
recurrence_schedule Object or null Object containing the recurrence_schedule information, if set. See below
related_payment Object or null Object containing the related_payment information, if set. See below
represented_collection_date date (YYYY-MM-DD) Date the represented was collected, if set
status string The Status of the Payment. See “Property Options” below

client Object Fields

Property Format Description
id string ID of the record

created_by Object Fields

Property Format Description
id string ID of the record

customer_account Object Fields

Property Format Description
id string ID of the record
legacy_id string or null Legacy ID of the record, if set

edited_by Object Fields

Property Format Description
id string ID of the record

recurrence_schedule Object Fields

Property Format Description
id string The ID of the Record
legacy_id string Legacy ID of the record, if set
Property Format Description
id string The ID of the Record
legacy_id string Legacy ID of the record, if set

direct_debit Object Fields

Property Format Description
bacs_description string or null The BACS Rejection Description, if set
bacs_filename string or null The BACS Rejection File Name, if set
bacs_reason_code string or null The BACS Rejection Reason Code, if set
bacs_reference string or null The BACS Reference, if set
default_narrative string or null Payments default narrative, if set
mandate object Object containing the mandate information. See below
originating_bank_account object Object containing the originating_bank_account information. See below
overriding_name string or null Payment overriding name, if set
service_user_number object Object containing the service_user_number information. See below
users_reference string or null Payment reference, if set

mandate Object Fields

Property Format Description
auddis string The Mandate/AUDDIS Reference of the Mandate
id string The ID of the Record

originating_bank_account Object Fields

Property Format Description
account_name string Account holder name
account_number string Account number
bank_name string Bank name
id string ID of the record
legacy_id string or null Legacy ID of the record, if set
sort_code string Sort code

service_user_number Object Fields

Property Format Description
id string The ID of the Record
sun_name string Friendly name for the service user number
sun_number string Service user number
  • Last modified: 2025/01/07 09:26