{"_id":"5d1d97e8be7f4e02188cce47","version":{"_id":"56326e9cdf556c0d00cd08ca","project":"544fc17e698ab40800b4f891","__v":22,"createdAt":"2015-10-29T19:08:12.724Z","releaseDate":"2015-10-29T19:08:12.724Z","categories":["56326e9ddf556c0d00cd08cb","56326e9ddf556c0d00cd08cc","56326e9ddf556c0d00cd08cd","56326e9ddf556c0d00cd08ce","56326e9ddf556c0d00cd08cf","56326e9ddf556c0d00cd08d0","56326e9ddf556c0d00cd08d1","56326e9ddf556c0d00cd08d2","56326e9ddf556c0d00cd08d3","56326e9ddf556c0d00cd08d4","56d942ac337fd11300d6a251","5ab2fcf66a1d77001230b47e","5afc2943bd2ef4000330bca7","5d1d87419a969a00141c6b4c","5d1d8948ef26b2002c6468d1","5d1d8afe7b2b24005bec7de0","5d1d8b24f5cfcb00201490bb","5d1d8bb82d46d1004a02581f","5d1d8de1e4edb0019ed63acd","5d1d8f6b613fb90050d0d3e0","5d1d934ed377870191039d28","5d1d99810b2e4600500eb5ff","5d1da14e613fb90050d0d491","5d229a846cf323005a7fa998","5d229a8c8abf65001cc4768d","5d229a9494b856002e26b6e1","5d229a9bf77bb900507ccb04","5d229aa88abf65001cc4768e","5d24310a9ca8c80054786177","5d24359101cc3a00508e7482","5d24418fa791b20050733b32"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"collector","version_clean":"2.1.0","version":"2.1"},"updatedAt":"2019-07-09T07:11:18.765Z","project":"544fc17e698ab40800b4f891","category":{"_id":"5d1d934ed377870191039d28","project":"544fc17e698ab40800b4f891","version":"56326e9cdf556c0d00cd08ca","isAPI":false,"__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2019-07-04T05:49:02.139Z","from_sync":false,"order":20,"slug":"payment-requests-1","title":"Payment Requests"},"user":"5d19a189b4596f0072f571d4","__v":3,"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-07-04T06:08:40.517Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"apiSetting":"5d1d8bb82d46d1004a02581d","examples":{"codes":[{"code":"import requests\n\nurl = \"https://coins.ph/api/v3/payment-requests/5edc263fac7f4f61b87632cb5710050f/\"\n\nheaders = {\n    'Accept': 'application/json'\n}\n\nresponse = requests.get(url, headers=headers)\n\nprint(response.text)","language":"python"},{"code":"curl -X GET \\\n  -H \"Content-Type: application/json;charset=UTF-8\" \\\n  -H \"Accept: application/json\" \\\n  \"https://coins.ph/api/v3/payment-requests/5eec262fac6f4f61b89932cb5610050e\"","language":"curl"},{"code":"require 'uri'\nrequire 'json'\nrequire 'net/http'\n\nurl = URI('https://coins.ph/api/v3/payment-requests/5edc263fac7f4f61b87632cb5710050f/')\n\nhttp = Net::HTTP.new(url.host, url.port)\nhttp.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url.request_uri)\nresponse = http.request(request)\nputs response.read_body","language":"ruby"}]},"results":{"codes":[{"name":"","code":"{\n    \"payment-request\": {\n        \"id\": \"5edc263fac7f4f61b87632cb5710050f\",\n        \"invoice\": \"5713e3ab76e74e6b85194deaf0f14cel\",\n        \"payer_contact_info\": \"example:::at:::example.com\",\n        \"payer_contact_info_type\": \"email\",\n        \"payer_email\": \"example@example.com\",\n        \"amount\": \"20.00000000\",\n        \"currency\": \"PHP\",\n        \"message\": \"Thanks for all the fish!\",\n        \"message_scope\": \"private\",\n        \"status\": \"pending\",\n        \"receiving_account\": \"5411c4604c9b45b8b74837c84daa0f4c\",\n        \"payment_url\": \"https://coins.ph/payment/request/5edc263fac7f4f61b87632cb5710050f\",\n        \"created_at\": \"2016-03-04T07:12:00.352338Z\",\n        \"updated_at\": \"2016-03-04T07:12:00.474500Z\",\n        \"expires_at\":\"2017-03-04T07:11:59.942484Z\"\n    }\n}\n\n","language":"json","status":200}]},"method":"get","settings":"","auth":"required","params":[{"_id":"5d1d97e8be7f4e02188cce49","ref":"","in":"path","required":false,"desc":"Optional. ID of the target payment request to retrieve. If not provided, a paginated list of payment requests will be returned.","default":"","type":"string","name":"id"},{"_id":"5d1d97e8be7f4e02188cce48","ref":"","in":"query","required":false,"desc":"Optional. Filter results by status - `pending`, `fulfilled`, or `expired`.","default":"","type":"string","name":"status"}],"url":"/api/v3/payment-requests/:id"},"isReference":true,"order":2,"body":"# Try it out real quick\n\nObtain an [OAuth2](doc:oauth) token and then replace `YOUR_TOKEN` in the following example.\n\n```curl\ncurl -X POST \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application/json;charset=UTF-8\" \\\n  -H \"Accept: application/json\" \\ \n  \"https://coins.ph/api/v3/payment-requests/\"\n```\n\n# Payment Requests\n\nA Payment Request is an attempt of a particular payee to ask for funds from another person. The payer need not be an existing coins user. To request for payment, the payee only needs to know at least one of the payor's details:\n\n* phone number\n* email address\n\nA successful payment request will send a notification through email or phone number, with a link where the payer may select a payment option. The payer could then select one of the currently available payment options. All options available to non-coins users are also available for current coins users.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/845b067-uRDyNO6AQt69ox7YMKeZ_Screen_Shot_2016-03-13_at_2_37_52_PM.jpg\",\n        \"uRDyNO6AQt69ox7YMKeZ_Screen_Shot_2016-03-13_at_2_37_52_PM.jpg\",\n        906,\n        1800,\n        \"#d9e7ef\"\n      ]\n    }\n  ]\n}\n[/block]\n## Coins Account\n\nCoins users can select this option to use one of their wallets to pay for the payment request. Funds will be transferred from the payers selected wallet to the payee's account.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/57fcfbe-GSoJcVBzSzCkHbT6inid_Screen_Shot_2016-03-13_at_2.55.25_PM.png\",\n        \"GSoJcVBzSzCkHbT6inid_Screen Shot 2016-03-13 at 2.55.25 PM.png\",\n        844,\n        1048,\n        \"#ebf3f9\"\n      ]\n    }\n  ]\n}\n[/block]\n## 7-Eleven Deposit\n\nPayers may choose this option to pay for the payment request by depositing funds through a 7-Eleven store. A 7-Connect reference number will be generated, along with a barcode which a payer could present to the store clerk for scanning.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f6fab8f-PyOeRtw0SGudWvLbpR8j_Screen_Shot_2016-03-13_at_2.47.28_PM.png\",\n        \"PyOeRtw0SGudWvLbpR8j_Screen Shot 2016-03-13 at 2.47.28 PM.png\",\n        844,\n        1314,\n        \"#ebecec\"\n      ]\n    }\n  ]\n}\n[/block]\n## M Lhuillier\n\nPayers may choose this option to pay for the payment request by depositing funds through an MLhuillier outlet. An EPay transaction code will be generated for the payment request. Funds for the payment request will be transferred to the payee's account once payment has been made through the specified transaction code.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f4a7b1b-pQBUqezpSE2Ipyr3xCo0_mle.jpg\",\n        \"pQBUqezpSE2Ipyr3xCo0_mle.jpg\",\n        844,\n        942,\n        \"#f6f6f7\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"Retrieve an existing or a list of existing payment requests","slug":"payment-requests-4","type":"endpoint","title":"payment-requests"}

getpayment-requests

Retrieve an existing or a list of existing payment requests

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
string
Optional. ID of the target payment request to retrieve. If not provided, a paginated list of payment requests will be returned.

Query Params

status:
string
Optional. Filter results by status - `pending`, `fulfilled`, or `expired`.

Examples


Result Format


Documentation

# Try it out real quick Obtain an [OAuth2](doc:oauth) token and then replace `YOUR_TOKEN` in the following example. ```curl curl -X POST \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json;charset=UTF-8" \ -H "Accept: application/json" \ "https://coins.ph/api/v3/payment-requests/" ``` # Payment Requests A Payment Request is an attempt of a particular payee to ask for funds from another person. The payer need not be an existing coins user. To request for payment, the payee only needs to know at least one of the payor's details: * phone number * email address A successful payment request will send a notification through email or phone number, with a link where the payer may select a payment option. The payer could then select one of the currently available payment options. All options available to non-coins users are also available for current coins users. [block:image] { "images": [ { "image": [ "https://files.readme.io/845b067-uRDyNO6AQt69ox7YMKeZ_Screen_Shot_2016-03-13_at_2_37_52_PM.jpg", "uRDyNO6AQt69ox7YMKeZ_Screen_Shot_2016-03-13_at_2_37_52_PM.jpg", 906, 1800, "#d9e7ef" ] } ] } [/block] ## Coins Account Coins users can select this option to use one of their wallets to pay for the payment request. Funds will be transferred from the payers selected wallet to the payee's account. [block:image] { "images": [ { "image": [ "https://files.readme.io/57fcfbe-GSoJcVBzSzCkHbT6inid_Screen_Shot_2016-03-13_at_2.55.25_PM.png", "GSoJcVBzSzCkHbT6inid_Screen Shot 2016-03-13 at 2.55.25 PM.png", 844, 1048, "#ebf3f9" ] } ] } [/block] ## 7-Eleven Deposit Payers may choose this option to pay for the payment request by depositing funds through a 7-Eleven store. A 7-Connect reference number will be generated, along with a barcode which a payer could present to the store clerk for scanning. [block:image] { "images": [ { "image": [ "https://files.readme.io/f6fab8f-PyOeRtw0SGudWvLbpR8j_Screen_Shot_2016-03-13_at_2.47.28_PM.png", "PyOeRtw0SGudWvLbpR8j_Screen Shot 2016-03-13 at 2.47.28 PM.png", 844, 1314, "#ebecec" ] } ] } [/block] ## M Lhuillier Payers may choose this option to pay for the payment request by depositing funds through an MLhuillier outlet. An EPay transaction code will be generated for the payment request. Funds for the payment request will be transferred to the payee's account once payment has been made through the specified transaction code. [block:image] { "images": [ { "image": [ "https://files.readme.io/f4a7b1b-pQBUqezpSE2Ipyr3xCo0_mle.jpg", "pQBUqezpSE2Ipyr3xCo0_mle.jpg", 844, 942, "#f6f6f7" ] } ] } [/block]