The following access URL's will be used based on the environment.
Environment | URL Format |
---|---|
Test Server | https://test.paybull.com/merchant/ |
Live Server | https://merchant.paybull.com/ |
There are two steps to get a token and they are defined in 1.2 and 1.3
At this API, an OTP will be sent to the merchant mobile number.
Method | URL | Content-Type |
---|---|---|
Post | application/json |
Type | Params | Data Type | Condition |
---|---|---|---|
KEY | string | Mandatory | |
KEY | password | string | Mandatory |
KEY | app_lang | string | Optional |
app_lang : app_lang parameter can be en/tr.
{
"statuscode": 46,
"description": "These credentials do not match with any record",
"data": []
}
{ "statuscode": 100,
"description": "Success",
"data": {
"user": {
"id": 1411,
"name": "John Doe ",
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"avatar": null,
"ip": null,
"tc_number": null,
"user_type": 2,
"account_status": 1,
"merchants": {
"id": 98950,
"user_id": 12,
"merchant_key": "$2y$10$w/ODdbTmfubcbUCUq/ia3OoJFMUmkM1UVNBiIQIuLfUlPmaLUT1he",
"site_url": "https://paybull.com/",
"success_link": "https://paybull.com/",
"fail_link": "https://paybull.com/",
}
In this API, merchants must verify using OPT that was sent at "GET OTP API 1.2".
Method | URL | Content-Type |
---|---|---|
POST | application/json |
Type | Params | Data Type | Condition |
---|---|---|---|
KEY | OTP | string | Mandatory |
KEY | user_id | number | Mandatory |
KEY | app_lang | string | Optional |
user_id: parameter should be taken from "GET OTP API 1.2" adımından alınacaktır.
OTP: Was sent at "GET OTP API 1.2" request.
app_lang: app_lang parameter can be en/tr.
{ "statuscode": 1,
"description": "OTP is expired or invalid",
"data": [] }
"statuscode": 100,
"description":
"Success",
"data": {
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiI5IiwianRpIjoiNjY0YWU3Nzc4ZGZ
jNDhiZDdj MDA2ZDE4NWRhZmNlMDI0YTQ5MzQzMGM2NTU4NDMzNzU1MWRjZTc5YzM1MzhhNjY5ODM1Nzc4NzA5Y
WFjZTIiLC JpYXQiOiIxNjE1NDYwNDU0LjExMTg1NCIsIm5iZiI6IjE2MTU0NjA0NTQuMTExODkxIiwiZXhwIjo
iMTY0Njk5 NjQ1NC4wNzAzNDMiLCJzdWIiOiIxNDExIiwic2NvcGVzIjpbXX0.in599EbVddgMPatSy94njSCxx
GZsSym_mp FYfHtfJxUZwgxp827oy8FjXdxGvpvrdSG8BMTI8Yu0Wb2KNxdAfusG8fOe6JL09fYbxjm2jxrMtx-b
dN03coKY gjNboRcSlyl3Dea-LFccePXDApASMzwmlfnKeJuWgOpXx3I2Lnj-TJDkjJdl5cgeO070wu0sZBMu62v
GYXW3fZ pMwCU1HQKDDhua7_OblytzR56M4HITDbJHJGOmJABpJjx4lurMIIBeObfPO6ZFXrkSTHRPoSq2orOEyd
REx6wa F4NNOu8FKlaXGmxs9RWBDNswjT5xQh8ndnoBKyknj2tpFmTrKAJpZM48Wn-VXOwEaDjG3OtkPVSi57ikW
TpHMu mIiCnIer8mrgRzV-0PJTSStkHYe63cdm6_JuWboD1Ju8m_9m1J5YeSQq6rt2MEQvbIz6Xxor6jCB3z8YbsF
jHe xgcZCMziMr4C7HWi7oB_SuXPuNpagWWdIm5PV4jlvMIJO2PwD6X9R8ppWmFhb8gL3f9qOKNFoYNWkUDvQ8sUM
G 2_56WNLYl2vlxDmUL7cYjYCf4QgWeMlqRRU8dbHWQSmKz4kKT3Tn1I5KkrPqvs4-uziithxhud6ThlsspDpQF1
aGQBMdPfPdMPnP1kyb_HrUB2FjTzT-Y3N_Klc3pE75D19rA",
"user": {
"id": 1411,
"name": "A.H.M Tareq",
"first_name": "A.H.M",
"last_name": "Tareq",
"email": "[email protected]",
"avatar": null,
"ip": null,
"tc_number": null,
"user_type": 2,
"account_status": 1,
"merchants": {
"id": 98950,
"user_id": 12,
"merchant_key": "$2y$10$w/ODdbTmfubcbUCUq/ia3OoJFMUmkM1UVNBiIQIuLfUlPmaLUT1he",
"site_url": "https://paybull.com/",
"success_link": "https://paybull.com/",
"fail_link": "https://paybull.com/",
}
}
}
}
In this API, Paybull supported currencies are being sent.
Method | URL | Content-Type |
---|---|---|
GET | application/json |
Type | Params | Data Type | Condition |
---|---|---|---|
HEADER | Authorization | string | Mandatory |
HEADER | Accept | string | Mandatory |
Authorization is a header key which defines verification that the connection attempt is allowed. The method should be “Bearer”.
Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImRlMGVlZGFiZjdhZDhkODYzYTgyMzQ4Nzk5NTFkYzFlMDZk
ZTUxYjU0NWRjYmU3MzRjMmQ1OGNkMWFlOWE4YjliZTkyMjdlZGVmZDdlMDliIn0.eyJhdWQiOiIxNSIsImp0aSI6Im
RlMGVlZGFiZjdhZDhkODYzYTgyMzQ4Nzk5NTFkYzFlMDZkZTUxYjU0NWRjYmU3MzRjMmQ1OGNkMWFlOWE4Yjli
ZTkyMjdlZGVmZDdlMDliIiwiaWF0IjoxNTczNzUyNDcyLCJuYmYiOjE1NzM3NTI0NzIsImV4cCI6MTYwNTM3NDg3Miw
ic3ViIjoiMSIsInNjb3BlcyI6W119.mDtdzcv15p8SnYjZYJUJrhdskO5NohXbkcAxKWWZ72lNtrg86RZ1yxQwfQlRu6IPoa
1rfG3M4jfsNeH-Sh7g6PaVffIoKvjdcUG7Cc2lLqhE4qMEdPgO28luCMOFf6UHn6XxeEhK3XWaboZJvrubdeb0t04a6bt
rdHUa-FgeV6I8bNSRlzUjOjBcsVrd1pxKhKnsREFHCWfzYVC_ZQ4RRCi9CZsJGz7_KQ8mo0BdNmtbNKwfvYkpcds
mVicsJYvnw7OMZ3u-TorhakndhQkUK0JPAzl_LSHqAKCju8dTG1-vZjbh9ifRB85TGwW4HimQk46RPG9Hp6kydLnuh
FOkbvGpaxcs5qyZ67-cmjDa6aeGNjZHfNa7dQ8bTokdbkxqwKrVVUUVjgkMtPXhpL9yffaHHPNBCkc-1Vz40nsmNFea
oWlk2S7fDxFTcGYv8HFFiSRyfsPpfTbXPIRMoZUX1kC4c-DMyQmjuBqtxIwEFzJexs9PkZEUze5Qcm_ZrkqeKUlL4tJi
dO9ZzwfCI9bpihMATHlDyM6IP7XyhgMRt3yr2WvzxuxavqSyu09YlybYU0WpTUtDVOavL7xnuKBXhwDSoCjtCMh__t
L9ZfK9lDvq6mrHQ5Z4RXLixvWMbl98_Btbnfg_SqnCNYwL14FSHyeb3lnuF8VFyERwbf-tAlI
{
"statuscode": 100,
"description": "Success",
"data": {
"currencies": [
{
"id": 1,
"name": "Turkish Lira",
"symbol": "",
"code": "TRY",
"iso_code": 949,
},
{
"id": 2,
"name": "Us Dollar",
"symbol": "$",
"code": "USD"
"iso_code": 840,
},
{
"id": 3,
"name": "Euro",
"symbol": "€",
"code": "EUR",
"iso_code": 978,
}
],
}
}
}