Initialize Purchase

This endpoint is used for buying e-pins. When you make a request, system reserves requested e-pins for a period of time (5 minutes) until you complete the process by confirming the purchase. This endpoint returns a token, which is used in confirming the purchase.

POST
/ purchases / init

Request Parameters

Parameter Type Required Description
CLIENT_ID String Yes Partner identifier provided by EpinTower
PRODUCT_PACK_CODE String Yes CODE acquired from products listing
QUANTITY Integer Yes Number of the pins requested. Maximum is 10 pins per request.
Note: For some products, only one pin is authorized per request and it is mentioned on the product list (Find more in get product).
TRANSACTION_ID String Yes The order id for the purchase transaction.
-It should by unique
-Max. length 45 characters
-Must contains only A-Z and/or 0-9 and/or - _ , no space
CUSTOMER_PHONE_NUMBER String No Customer's phone number (with the country Code) eg. 905051234567.
CUSTOMER_ID String No Customer's id eg. 123a4b. Only alphanumeric and "-", "_" characters are allowed
CUSTOMER_FULL_NAME String No Customer's full name
CUSTOMER_IDENTITY_NUMBER String No Customer's Turkish Identity Number
CUSTOMER_ADDRESS String No Customer's address
CUSTOMER_TOWN String No Customer's town
CUSTOMER_CITY String No Customer's city
CUSTOMER_EMAIL String No Customer's email
SIGNATURE String Yes You need to calculate it as mentioned in security section.
- Data to sign in order : CLIENT ID, SECRET KEY, TRANSACTION ID

CUSTOMER_PHONE_NUMBER and CUSTOMER_ID fields are not compulsory, but if you want to track the customers activity, either one of the fields should be valid to use purchase history

Response Parameters

Parameter Type Description
PURCHASE_TOKEN String Is used in requests when confirming the purchase
TRANSACTION_ID String The order id for the purchase transaction.
EXPIRES_AT String Gives the date token expires at
RESPONSE_CODE Integer Returned value of “0” implies transaction is successfully completed.
If the code is not "0", it means an error. See error codes section.
RESPONSE_MESSAGE String Response message for requested transaction
RESPONSE_ID String Response id for requested transaction
SIGNATURE String You need to calculate it as mentioned in security section.
- Data to sign in order : CLIENT ID, SECRET KEY, TRANSACTION ID