Note : Please let us know your server IP list before start integration for whitelisting on our system.
Payment
Live URL: https://api. /pw/v3/storedPaymentTest URL: https://testapi. /pw/v3/storedPayment
Parameters
| Parameter Name | Detail | Example | Type | Always There |
|---|---|---|---|---|
| apiKey | Your Api Key provided from us. | 4d41d21a935f5bba9dee7 c7be4a7ca04 | Char 32 | ✔ |
| storedCardId | Store Card For Next Payment | 6-1474539891-0-1 | Char 255 | ✔ |
| amount | Amount in cents of the transaction. | 1234 for 12.34 € 1550 for 15.50 USD | Int | ✔ |
| currency | The currency of transaction. | EUR | Char 3 | ✔ |
| referenceNo | Your own transaction identifier. | 1-1386413490-0089-14 | Char 32 | ✔ |
| timestamp | Unix timestamp | 1441190134 | Char 32 | ✔ |
| returnUrl | Valid URL where the client is redirected after payment completion. | https://www.yourstore.co m/order_confirmation_132 2_ABC | Char 256 | ✔ |
| language | Payment Language | Please check Supported languages | Char 2 | |
| billingPhone | The customer phone number.(Full international number) | 00909990000000 | Char 25 | ✔ |
| paymentMethod | Default selected payment method | Please check Supported payment methods | Char 32 | ✔ |
| sessionId | A unique identifier of the user session, for example tracking cookies. | DLFJKFU474949H497 | Char 255 | |
| passwordHash | Hash of the user’s password in ASCII encoding (e.g. MD5, SHA-2 family) | JKFSDF4573637DHFHFH | Char 255 | |
| userCreated | Date of user first registered to your site in UNIX time format and UTC time zone. | 1446370717 (Sun, 01 Nov 2015 09:38:37 +0000) | Char 255 | |
| walletId | A unique identifier of wallet. | 11604623c851ff74d060d8f5240056531 | Char 255 |
Example Integration Request
curl -i -X POST \
-H "Content-Type:application/x-www-form-urlencoded" \
-d "apiKey=1234" \
-d "storedCardId=244-1481634103-0-1" \
-d "amount=1000" \
-d "currency=EUR" \
-d "referenceNo=ref-123123123" \
-d "paymentMethod=VISA" \
-d "returnUrl=https://returnurl.com" \
'REQUEST_ENDPOINT_URL_COMES_HERE(SEE BELOW)'
Successful Response
| Parameter Name | Detail | Example |
|---|---|---|
| status | Status of the transaction | PENDING |
| amount | Amount in cents of the transaction. | 1234 for 12.34 € 1550 for 15.50 |
| currency | The currency of transaction | EUR |
| type | Authorization type | AUTH |
| referenceNo | Your own transaction identifier. | 1-1386413490-1289-14 |
| operation | The operation type | STORED |
| returnUrl | Valid URL where the client is redirected after payment completion. | https:// /return |
| paymentMethod | Default selected payment method | VISA |
| transactionId | Our transaction identifier | 123-123456789-123456 |
| message | Return message that includes details for response | Waiting |
| code | Response code of the message | 283 |
| purchaseUrl | The URL which for your customers to be redirected to | https://gateway. /payment/initialize/12-32345-3424323 |
Unsuccessful Response
| Parameter Name | Detail | Example |
|---|---|---|
| status | Status of the transaction | DECLINED |
| message | Return message that includes details for response | Amount is required |
| code | Response code of the message | 188 |
Supported Payment Methods Codes
- VISA
Processing Integration Test
You need store card start to test this feature. Please follow at the below steps
- (1) You need to complete standart purchase via supported purchase method
- (2) You must send storeCard parameter as yes, when we receive the credit card data we will store the card and inform you via IPN call for related transaction
Remove Stored Card
Note : Please let us know stored card can be removed only from merchant that is stored it on our system.
Live URL: https://api. /pw/v3/removeStoredCardTest URL: https://testapi. /pw/v3/removeStoredCard
Parameters
| Parameter Name | Detail | Example | Type | Always There |
|---|---|---|---|---|
| apiKey | Your Api Key provided from us. | 4d41d21a935f5bba9dee7c7be4a7ca04 | Char 32 | ✔ |
| storedCardId | Store Card For Next Payment | 6-1474539891-0-1 | Char 255 | ✔ |
Example Integration Request
curl -i -X POST \
-H "Content-Type:application/x-www-form-urlencoded" \
-d "apiKey=1234" \
-d "storedCardId=244-1481634103-0-1" \
'REQUEST_ENDPOINT_URL_COMES_HERE(SEE BELOW)'
Successful Response
| Parameter Name | Detail | Example |
|---|---|---|
| status | Status of the transaction | APPROVED |
| storedCardId | Store Card For Next Payment | 6-1474539891-0-1 |
Unsuccessful Response
| Parameter Name | Detail | Example |
|---|---|---|
| status | Status of the transaction | DECLINED |
| message | Return message that includes details for response | StoredCardId is required |
| code | Response code of the message | 216 |