.. index:: Advertisement, AdvertisementTransactions AdvertisementTransaction .. _advertisement_transaction: Advertisement transaction ========================= A transaction is an instance of buying for an advertisement where the payment is not handled by Marktplaats but by a third-party (e.g. Media Medics). The third-party in this case will make sure that the purchase amount is received by the seller. .. note:: Work in Progress Fields ------ .. apifields:: .. apifield:: :name: transactionId :type: int :constraints: -- :required: false :writable: false :updateable: false :description: The transaction id. .. apifield:: :name: buyerId :type: int :constraints: -- :required: true :writable: true :updateable: false :description: The buyer id. .. apifield:: :name: amount :type: int :constraints: non negative :required: true :writable: true :updateable: false :description: The transaction amount. .. apifield:: :name: shippingCosts :type: int :constraints: non negative :required: true :writable: true :updateable: false :description: The shipping costs. .. apifield:: :name: status :type: string :constraints: -- :required: false :writable: false :updateable: false :description: The status of the transaction. Reference --------- .. endpoint:: GET /v1/advertisements/{itemId}/transactions/{transactionId} Returns specific transaction on the advertisement. Errors ------ .. errors:: .. error:: :http: 403 :code: unauthorized :description: The user does not own the advertisement or transaction .. error:: :http: 404 :code: transaction-not-found :description: The transaction doesn't exist Examples -------- .. include:: examples/get-transaction-example.rst Notification ------------ Third-party can expect the following notification structure from Marktplaats for any transaction status changes: .. include:: examples/transaction-notification-example.rst The endpoint of the callback will for now be configured by Marktplaats until a future self-service implementation in the API becomes available.