Deposit to a member's wallet can be done in 2 ways. One of them is to deposit money into the wallet from a card. Secondly, you can deposit money based on the EFT/Money Transfer transaction made by the member to your bank account.
You can use this service to deposit money into a member's wallet from credit credit or debit card.
The endpoint and http method information to deposit to member wallet are stated below.
HTTP Method | URL |
---|---|
POST |
/payment/v1/deposits |
The parameters expected to be sent in the requests to be made for deposit to member wallet are listed under the table and sub-headings below.
Parameter Name | Type | Mandatory | Description |
---|---|---|---|
price |
decimal |
Yes | Amount to be top-up |
buyerMemberId |
number |
Yes | The ID value of the buyer membet who is related to payment. This ID value is not the id value that is stored in merchant own system. It is the value stored in Craftgate. |
conversationId |
string |
No | "boomerang" value that can be sent with the request and received with the response. It can be used to associate different requests with each other. Usually, the order number is used that is stored in merchant own system. |
posAlias |
string |
No | The alias value of the POS that the payment pass over |
card |
Card |
No | Card information to be collected (See. Card Information) |
clientIp |
string |
No | IP of the buyer who created payment request |
If the cardUserKey
field in the sent card information is filled in, the fields in the Stored Card Information section are valid. For other cases, see: Credit Card, Debit Card or Prepaid Card Information.
The parameters returned as a result of deposit to wallet 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 value of payment |
createdDate |
date |
The date that payment created |
price |
decimal |
Amount that top-up to the wallet |
currency |
string |
Payment currency |
buyerMemberId |
number |
The ID value of the buyer member who is related to payment. |
conversationId |
string |
Value of theconversationId parameter sent in the payment initiation request |
paymentType |
PaymentType |
See: Payment Types |
paymentStatus |
PaymentStatus |
See: Payment Statuses |
authCode |
string |
authCode value retrieved from bank related to the payment |
hostReference |
string |
hostReference value retrieved from bank related to the payment |
transId |
string |
transId value retrieved from bank related to the payment |
orderId |
string |
orderId value retrieved from bank related to the payment |
cardUserKey |
string |
This value exist for the payment that has the storeCardAfterSuccessPayment field in the card information field as true in payment request. Indicates the hidden card key of the stored card after successful payment. It should be stored by the merchant by associating it with the customer. |
cardToken |
string |
This value exist for the payment that has the storeCardAfterSuccessPayment field in the card information field as true in payment request. Indicates the hidden card token of the stored card after successful payment. It should be stored by the merchant by associating it with the customer. |
walletTransaction |
WalletTransaction |
(bkz. Wallet Transaction) Wallet transaction record that is created while deposit process |
fraudId |
number |
Fraud Check Id if fraud rule matches (See: Fraud Checks) |
fraudAction |
FraudAction |
Fraud Check Action if fraud rule matches (See: Fraud Actions) |
Parameters returned as a result of wallet transaction.
Parameter Name | Type | Description |
---|---|---|
id |
number |
ID value of the wallet transaction |
walletTransactionType |
string |
Type of the wallet transaction |
amount |
decimal |
Amount value of the wallet transaction |
walletId |
number |
ID value of the related wallet |
To refund the money that is deposit to wallet, to the card, visit the Refund Wallet Transaction to Card page.
You can review the sample codes in the open source Craftgate API clients.
You can deposit money to the member's wallet based on the EFT/Transfer transaction from the member to your bank accounts.
The endpoint and http method information to deposit to member wallet depending on EFT/Money Transfer are stated below.
HTTP Method | URL |
---|---|
POST |
/payment/v1/deposits/fund-transfer |
The parameters expected to be sent in the requests to be made for deposit to member wallet depending on EFT/Money Transfer are listed under the table and sub-headings below.
Parameter Name | Type | Description | |
---|---|---|---|
price |
decimal |
Yes | Amount to be top-up |
buyerMemberId |
number |
Yes | Buyer member ID. This ID value is not the id value that is stored in merchant own system. It is the value stored in Craftgate. |
conversationId |
string |
No | "boomerang" value that can be sent with the request and received with the response. It can be used to associate different requests with each other. Usually, the order number is used that is stored in merchant own system. |
clientIp |
string |
No | IP of the buyer who created payment request |
The parameters returned as a result of deposit to wallet 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 |
---|---|---|
currency |
string |
Payment currency |
buyerMemberId |
number |
The ID value of the buyer member who is related to payment. |
conversationId |
string |
Value of theconversationId parameter sent in the payment initiation request |
walletTransaction |
WalletTransaction |
(bkz. Wallet Transaction) Wallet transaction record that is created while deposit process |
You can review the sample codes in the open source Craftgate API clients.