Update Payment Transaction

Marketplace merchants can update payment transactions after payment is made. Sub merchant member and/or sub merchant prices can be changed during this operation.

Some important points to consider:

  • Only marketplace merchants can use this feature.
  • Only transactions of product payments can be updated.
  • At least one of "Seller member" and "seller member's price" fields should be updated.
  • Payment status should succeed.
  • Payment should not be refunded or cancelled.
  • Payment transaction should not be approved.
  • Update is not allowed if settlement is started or completed.
  • If all the points above are fulfilled, update can be done multiple times.

URL

The endpoint and http method information to withdraw approval of a payment transaction are stated below.

HTTP Method URL
PUT /payment/v1/payment-transactions/:paymentTransactionId

Request Parameters

The parameters expected to be sent in the requests to be made to update payment transaction are listed under the table and sub-headings below.

Parameter Name Type Required Description
subMerchantMemberId number Yes Sub merchant member id for payment transaction
subMerchantMemberPrice number Yes Sub merchant member price for payment transaction

Response Parameters

The parameters returned as a result of the payment are also subject to the rules specified in the Response Formats section of the API documentation home page. In the absence of a systematic or fictional error, the sub-parameters of the object returned in the data parameter are as follows:

Parameter Name Type Description
id number ID of the payment transaction
externalId string External ID of the payment item that is sent in the request
name string Name of the payment item that is sent in the request
price decimal Basket price of the payment item
paidPrice decimal Paid price of the payment item
walletPrice decimal Wallet price of the payment item
merchantCommissionRate decimal Merchant's interest rate of the payment transaction
merchantCommissionRateAmount decimal Merchant's interest rate amount of the payment transaction
merchantPayoutAmount decimal Merchant's payout amount of the payment transaction
subMerchantMemberId number ID of the sub-merchant
subMerchantMemberPrice decimal Sub-merchant requested payout amount for the payment item.
subMerchantMemberPayoutRate decimal Sub-merchant payout rate for the payment item.
subMerchantMemberPayoutAmount decimal Sub-merchant payout amount for the payment item.
transactionStatus TransactionStatus See: Payment Item Confirmation Status Status of payment transaction confirmation
blockageResolvedDate date Date that the blockage will be resolved
payout Payout (ee: Payment Transactions Distribution of Payout

Sample Codes

You can review the sample codes in the open source Craftgate API clients.