Card Event
Event structure and samples for Cards.
Card Event - Structure
Note: Version 2 Webhooks can contain more that one event per webhook. Please see “V2 Webhook Structure” for more details.
Event Fields
| Property | Format | Description |
|---|---|---|
| allow_repeat_payments | boolean | If repeat payments can be made from the card |
| card_expiry_date | date (YYYY-MM-DD) or null | The expiry date of the card |
| card_holder_address_city | string or null | Card holder city |
| card_holder_address_country_code | string (ISO 3166-1 alpha-2) | Card holder country code |
| card_holder_address_line1 | string or null | Card holder address line 1 |
| card_holder_address_line2 | string or null | Card holder address line 2 |
| card_holder_address_postal_code | string or null | Card holder postcode |
| card_holder_address_state_code | string or null | Card holder state code |
| card_number_ending | string or null | Typically the last four digits of the long card number |
| card_type | string or null | The card association for the card. Visa, Amex, etc |
| client | object | Object containing the client information, see below |
| 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 | ISO 4217 representation of the currency used for the card payment |
| custom_reference | string or null | The Custom reference |
| customer_account | object or null | Object containing Customer Account information, if set, see below |
| edited_at | datetime (ISO8601) | Date and time the record was edited |
| edited_by | object or null | Object containing the edited_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 “card_payment.create” or “card_payment.update” |
| gateway_card_id | string or null | Unique identifier of the card passed to SmarterPay from the gateway |
| gateway_payee_id | string or null | Unique identifier of the payee passed to SmarterPay from the gateway |
| gateway_payment_description | string or null | A description of payment that is passed onto the gateway and may be shared with the customer |
| gateway_status | string or null | The status of the card passed by the gateway to SmarterPay |
| gateway_status_code | string or null | A code that the gateway may pass to SmarterPay to further describe the status |
| gateway_status_details | string or null | Additional information, based on the status, passed by the gateway to SmarterPay |
| id | string | The ID of the Record |
| initial_amount | interger | The amount initially charged to the card. |
| internal_payment_description | string or null | A description of payment that is only for 'office use' and not shared with a customer |
| legacy_id | string or null | Legacy ID of the record, if set |
| metadata | string or null | Additional client JSON initially passed in the card registration request that is sent with every webhook |
| name_on_card | string | The name of the person who owns the card |
| payment_gateway | string | The name of the payment gateway used to register the card |
| payment_gateway_profile | object | Object containing the payment gateway profile information, see below |
| status | string | SmarterPay's normalised status of the card |
| status_code | string or null | Card payments status code |
| status_details | string or null | SmarterPay's additional information based on the status |
| transaction_type | string | What type of transaction took place. For example: Ecommerce or MOTO |
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 |
payment_gateway_profile 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},
"event_id":{VALUE},
"created_at":{VALUE},
"edited_at":{VALUE},
"custom_reference":{VALUE},
"event_type":{VALUE},
"event_source":{VALUE},
"payment_gateway":{VALUE},
"card_type":{VALUE},
"card_number_ending":{VALUE},
"card_expiry_date":{VALUE},
"name_on_card":{VALUE},
"internal_payment_description":{VALUE},
"gateway_payment_description":{VALUE},
"gateway_payee_id":{VALUE},
"gateway_card_id":{VALUE},
"transaction_type":{VALUE},
"status":{VALUE},
"status_details":{VALUE},
"status_code":{VALUE},
"currency_code":{VALUE},
"initial_amount":{VALUE},
"metadata":{VALUE},
"gateway_status":{VALUE},
"gateway_status_code":{VALUE},
"gateway_status_details":{VALUE},
"card_holder_address_line1":{VALUE},
"card_holder_address_line2":{VALUE},
"card_holder_address_city":{VALUE},
"card_holder_address_postal_code":{VALUE},
"card_holder_address_country_code":{VALUE},
"card_holder_address_state_code":{VALUE},
"allow_repeat_payments":{VALUE},
"client":{
"id":{VALUE}
},
"created_by":{
"id":{VALUE}
},
"edited_by":{
"id":{VALUE}
},
"payment_gateway_profile":{
"id":{VALUE},
"description":{VALUE}
},
"customer_account":{
"id":{VALUE},
"legacy_id":{VALUE}
}
}
]
}
Note: Property display order for documentation purposes, actual order may vary.
Notes:
- Properties displayed in alphabetical order for documentation purposes, actual order will vary.
Card Event - Samples
Card Event - Sample - General
Card Event - Sample - Record Creation
The fields that have been updated for this webhook are:
| Field | Sample Value |
|---|---|
| id | “CD0175OW1YJVQK8X29LV” |
| legacy_id | null |
| event_id | “HI08EXYR6K8KEY84ZLQV” |
| created_at | “2024-04-09T09:38:29Z” |
| edited_at | “2024-04-09T09:38:29Z” |
| custom_reference | null |
| event_type | “card_payment.create” |
| event_source | “API” |
| payment_gateway | “OpayoPi” |
| card_type | null |
| card_number_ending | null |
| card_expiry_date | null |
| name_on_card | null |
| internal_payment_description | null |
| gateway_payment_description | null |
| gateway_payee_id | null |
| gateway_card_id | null |
| transaction_type | “MOTO” |
| status | “pending” |
| status_details | null |
| status_code | null |
| currency_code | “GBP” |
| initial_amount | 2750 |
| metadata | null |
| gateway_status | null |
| gateway_status_code | null |
| gateway_status_details | null |
| card_holder_address_line1 | null |
| card_holder_address_line2 | null |
| card_holder_address_city | null |
| card_holder_address_postal_code | null |
| card_holder_address_country_code | null |
| card_holder_address_state_code | null |
| allow_repeat_payments | true |
| client:id | “CL01LG420EJ9DP1VQWR9” |
| created_by | null |
| edited_by | null |
| payment_gateway_profile:id | “PG01RZO41Y8DOJ0GNLW7” |
| payment_gateway_profile:description | “Opayo Payment Gateway” |
| customer_account:id | “CA01ZO41Y8DZ19P0GNLW” |
| customer_account:legacy_id | null |
{
"id":{VALUE},
"idempotency_key":{VALUE},
"sent_at":{VALUE},
"client":
{
"id":{VALUE}
},
"events":[
{
"id":{VALUE},
"legacy_id":{VALUE},
"event_id":{VALUE},
"created_at":{VALUE},
"edited_at":{VALUE},
"custom_reference":{VALUE},
"event_type":{VALUE},
"event_source":{VALUE},
"payment_gateway":{VALUE},
"card_type":{VALUE},
"card_number_ending":{VALUE},
"card_expiry_date":{VALUE},
"name_on_card":{VALUE},
"internal_payment_description":{VALUE},
"gateway_payment_description":{VALUE},
"gateway_payee_id":{VALUE},
"gateway_card_id":{VALUE},
"transaction_type":{VALUE},
"status":{VALUE},
"status_details":{VALUE},
"status_code":{VALUE},
"currency_code":{VALUE},
"initial_amount":{VALUE},
"metadata":{VALUE},
"gateway_status":{VALUE},
"gateway_status_code":{VALUE},
"gateway_status_details":{VALUE},
"card_holder_address_line1":{VALUE},
"card_holder_address_line2":{VALUE},
"card_holder_address_city":{VALUE},
"card_holder_address_postal_code":{VALUE},
"card_holder_address_country_code":{VALUE},
"card_holder_address_state_code":{VALUE},
"allow_repeat_payments":{VALUE},
"client":{
"id":{VALUE}
},
"created_by":{
"id":{VALUE}
},
"edited_by":{
"id":{VALUE}
},
"payment_gateway_profile":{
"id":{VALUE},
"description":{VALUE}
},
"customer_account":{
"id":{VALUE},
"legacy_id":{VALUE}
}
}
]
}
Note: Property display order for documentation purposes, actual order may vary.
Card Event - Sample - Record Update
The fields that have been updated for this webhook are:
| Field | Sample Value |
|---|---|
| event_id | “HI08EXYR6K8KEY84ZLQV” |
| created_at | “2024-04-09T09:38:29Z” |
| edited_at | “2024-04-09T09:38:29Z” |
| event_type | “card_payment.update” |
| event_source | “API” |
| card_type | “Visa” |
| card_number_ending | “0006” |
| card_expiry_date | “2025-01-31” |
| internal_payment_description | “Payment from Ecommerce Page” |
| status | “failed” |
| gateway_status | “Error” |
| gateway_status_code | “1021” |
| gateway_status_details | “This release amount will exceed the amount of the original transaction” |
{
"id":{VALUE},
"idempotency_key":{VALUE},
"sent_at":{VALUE},
"client":
{
"id":{VALUE}
},
"events":[
{
"id":{VALUE},
"legacy_id":{VALUE},
"event_id":{VALUE},
"created_at":{VALUE},
"edited_at":{VALUE},
"custom_reference":{VALUE},
"event_type":{VALUE},
"event_source":{VALUE},
"payment_gateway":{VALUE},
"card_type":{VALUE},
"card_number_ending":{VALUE},
"card_expiry_date":{VALUE},
"name_on_card":{VALUE},
"internal_payment_description":{VALUE},
"gateway_payment_description":{VALUE},
"gateway_payee_id":{VALUE},
"gateway_card_id":{VALUE},
"transaction_type":{VALUE},
"status":{VALUE},
"status_details":{VALUE},
"status_code":{VALUE},
"currency_code":{VALUE},
"initial_amount":{VALUE},
"metadata":{VALUE},
"gateway_status":{VALUE},
"gateway_status_code":{VALUE},
"gateway_status_details":{VALUE},
"card_holder_address_line1":{VALUE},
"card_holder_address_line2":{VALUE},
"card_holder_address_city":{VALUE},
"card_holder_address_postal_code":{VALUE},
"card_holder_address_country_code":{VALUE},
"card_holder_address_state_code":{VALUE},
"allow_repeat_payments":{VALUE},
"client":{
"id":{VALUE}
},
"created_by":{
"id":{VALUE}
},
"edited_by":{
"id":{VALUE}
},
"payment_gateway_profile":{
"id":{VALUE},
"description":{VALUE}
},
"customer_account":{
"id":{VALUE},
"legacy_id":{VALUE}
}
}
]
}
Note: Property display order for documentation purposes, actual order may vary.