Skip to main content

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.

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.

subMerchantMemberId
number
required

Sub merchant member id for payment transaction

subMerchantMemberPrice
number
required

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:

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

Values:
WAITING_FOR_APPROVAL
APPROVED
blockageResolvedDate
date

Date that the blockage will be resolved

payout
Payout

See: Payment Transactions Distribution of Payout

Sample Codes​

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

Java.NETPHPNode.jsGo