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:
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 |
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 |
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 |
You can review the sample codes in the open source Craftgate API clients.