Update the Smart Transaction

These details of a Smart Transaction can be changed before it is started:

  • customer data and shipping address;

  • basket and total sum;

  • the purpose (transactionRef);

  • the order or customer ID (merchantRef);

  • the delivery options.

If you update an approved transaction, the payment authorisation is lost, and it changes back to the created status. You must repeat the authorisation process.

In order to update the Smart Transaction you have to address its PUT /api/v2/Smart/Transactions/{id}:

Request
PUT /api/v2/Smart/Transactions/STX_2UYAHWYC32X2GT37V32E8BPRNUA2A3 HTTP/1.1
Host: connect-testing.secupay-ag.de
Authorization: Bearer qb56tjj1bcvo9n2nj4u38k84lo
Content-Type: application/json
Accept: application/json
 
{
"is_demo": true,
"contract": {
"id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
},
"customer": {
"id": "PCU_3J7GCMPPE2X2GT37V32E8BPRNUA2AW"
},
"transactionRef": "ORD-900012345",
"merchantRef": "CUST-500000321",
  "basket": {
"products": [
{
"item_type": "sub_transaction",
"desc": "Order for Muster-Elektrogeräte GmbH",
"sum": 9350,
"reference_id": "1002",
"contract_id": "GCR_ZPMJGRH4SU3X0H3Y3WYB69XVXAG8PJ",
"sub_basket": [
{
"id": 1,
"articleNumber": 1,
"desc": "Coffee maker with remote control",
"quantity": 2,
"priceOne": 5000,
"tax": 19
},
{
"id": 2,
"item_type": "coupon",
"desc": "Coupon €10",
"quantity": 1,
"priceOne": 1000,
"tax": 19
},
{
"id": 1000,
"item_type": "shipping",
"name": "Standard delivery 2-3 days",
"quantity": 1,
"priceOne": 350,
"tax": "19"
},
{
"item_type": "stakeholder_payment",
"desc": "Marketplace fee",
"sum": 150,
"reference_id": "fee",
"contract_id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
}
]
}
]
},
"basket_info": {
"sum": 9350,
"currency": "EUR"
},
"payment_context": {
"auto_capture": true
},
"delivery_options": {
"type": "collection",
"scheduled_slot": {
"start_date": "2020-07-06T12:45:00+02:00",
"end_date": "2020-07-06T14:45:00+02:00"
},
"store_id": "STO_WCH2ABG8T7U8WHWDF3EG5KV2P6C4PM"
}
}

You must send the full object representation. Values managed by our system are ignored. You can send or leave them.

If everything is fine, the API responds with 200 OK, and the object representation:

Response
HTTP/1.1 200 OK
Content-Type: application/json
...
 
{
"object": "smart.transactions",
"id": "STX_2UYAHWYC32X2GT37V32E8BPRNUA2A3",
"merchant": {
"object": "general.merchants",
"id": "MRC_WVHJQFQ4JNVYNG5B55TYK748ZCHQP8",
"companyname": "Secupay Test-Shop"
},
"contract": {
"object": "general.contracts",
"id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0"
},
"customer": {
"object": "payment.customers",
"id": "PCU_3J7GCMPPE2X2GT37V32E8BPRNUA2AW",
"contact": {
"forename": "Lesley",
"surname": "Mustermann",
"address": {
"street": "Musterstr.",
"street_number": "840",
"additional_address_data": "App. 506",
"postal_code": "09999",
"city": "East Palmaside",
"country": "DE"
},
"email": "Andrew37@example.org"
        "phone": "+49 555 5555555",
"mobile": "+49 177 5555555",
          "dob": "1965-12-31T00:00:00+01:00"
}
},
// ...
"created": "2021-03-16T18:20:15+01:00",
"updated": "2020-11-06T10:43:05+01:00",
  "status": "created",
"transactionRef": "ORD-900012345",
"merchantRef": "CUST-500000321",
   // ...
"intent": "sale",
"basket": {
"products": [{
"item_type": "sub_transaction",
"desc": "Order for Muster-Elektrogeräte GmbH",
"reference_id": "1002",
"contract_id": "GCR_ZPMJGRH4SU3X0H3Y3WYB69XVXAG8PJ",
"sum": 9500,
"sub_basket": [{
"id": 1,
"parent": null,
"item_type": "article",
"desc": "Coffee maker with remote control",
"articleNumber": "1",
"ean": "",
"quantity": 2,
"priceOne": 5000,
"tax": 19,
"reference_id": null,
"group": []
}, {
"id": 2,
"parent": null,
"item_type": "coupon",
"desc": "Coupon \u20ac10",
"articleNumber": "",
"ean": "",
"quantity": 1,
"priceOne": 1000,
"tax": 19,
"reference_id": null,
"group": []
}, {
"id": 1000,
"parent": null,
"item_type": "shipping",
"desc": "Standard delivery 2-3 days",
"articleNumber": "",
"ean": "",
"quantity": 1,
"priceOne": 350,
"tax": "19",
"reference_id": null,
"group": []
}, {
"item_type": "stakeholder_payment",
"desc": "Marketplace fee",
"reference_id": "fee",
"contract_id": "GCR_2H69XY35227V2VKP9WRA3SJ0W95RP0",
"sum": 150
}]
}],
"type": "mixed"
      // ...
},
"basket_info": {
"sum": 9350,
// ...
"currency": "EUR"
},
// ...
"delivery_options": {
"type": "collection",
"code": null,
"store_id": "STO_WCH2ABG8T7U8WHWDF3EG5KV2P6C4PM",
"scheduled_slot": {
"start_date": "2020-07-06T12:45:00+02:00",
"end_date": "2020-07-06T14:45:00+02:00"
},
"delivered_at": null
},
// ...
"payment_context": {
"auto_capture": true,
"payment_methods": null
},
// ...
}

The new status is created.