{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/v1/sellorder/:sell_order_id","auth":"required","apiSetting":"5d1d8bb82d46d1004a02581d","examples":{"codes":[{"language":"python","code":"import requests\n\nTOKEN = 'YOUR TOKEN'\nurl = 'https://api.coins.asia/v1/sellorder'\n\nheaders = {\n    'Authorization': 'Bearer {}'.format(TOKEN),\n    'Accept': 'application/json'\n}\n\nrequests.get(url, headers=headers)"}]},"results":{"codes":[{"status":200,"language":"json","code":"\"orders\": [\n        {\n            \"amount\": \"50\",\n            \"bank_account_name\": \"Test Account\",\n            \"bank_account_number\": \"xxxxxxxx1234\",\n            \"btc_amount\": \"0.0000771\",\n            \"btc_pending\": \"0\",\n            \"btc_received\": \"0\",\n            \"confirmation_code\": \"425f200a\",\n            \"confirmations\": [],\n            \"created_time\": \"1562751276\",\n            \"currency\": \"PHP\",\n            \"currency_amount\": \"50\",\n            \"currency_amount_locked\": \"50\",\n            \"currency_amount_received\": \"0\",\n            \"currency_fees\": \"0\",\n            \"currency_fees_locked\": \"0\",\n            \"currency_net\": \"50\",\n            \"currency_settled\": \"0\",\n            \"delivery_status\": \"pending_payment\",\n            \"due_btc_amount\": \"0.0000771\",\n            \"estimated_delivery_time\": null,\n            \"expires_epoch\": \"1562754936\",\n            \"expires_in_seconds\": \"1766.484568\",\n            \"external_transaction_id\": null,\n            \"favorite_id\": null,\n            \"fields\": {\n                \"bank_account_name\": \"Test Account\",\n                \"bank_account_number\": \"xxxxxxxx1234\"\n            },\n            \"id\": \"425f200a5e3c4ca7a8b83004aed7c7e2\",\n            \"instructions\": \"\",\n            \"is_claiming_details_resend_enabled\": false,\n            \"is_claiming_details_resendable\": false,\n            \"is_express\": false,\n            \"is_favorite\": false,\n            \"is_refunded\": false,\n            \"metadata\": {},\n            \"payment_account\": {\n                \"id\": \"63b78af2f5854a8ab40711b8fec77681\",\n                \"payment_outlet\": {\n                    \"id\": \"bdo\",\n                    \"name\": \"BDO\"\n                },\n                \"required_fields\": [\n                    {\n                        \"legend\": \"Account Holder Name\",\n                        \"name\": \"bank_account_name\",\n                        \"value\": \"Test Account\"\n                    },\n                    {\n                        \"legend\": \"Bank Account Number\",\n                        \"name\": \"bank_account_number\",\n                        \"value\": \"xxxxxxxx1234\"\n                    }\n                ]\n            },\n            \"payment_outlet_id\": \"bdo\",\n            \"payment_outlet_name\": \"BDO\",\n            \"payment_outlet_type_id\": \"bank\",\n            \"payments\": [],\n            \"payout_duration\": \"Varies per bank\",\n            \"qr_img_uri\": \"https://chart.googleapis.com/chart?chl=bitcoin%3A3QDLzerVjkRFooXJtd6ou1SJELPfK294Le%3Famount%3D0.00007710&chs=400x400&cht=qr&choe=UTF-8&chld=L%7C0\",\n            \"qr_img_url\": \"https://chart.googleapis.com/chart?chl=bitcoin%3A3QDLzerVjkRFooXJtd6ou1SJELPfK294Le%3Famount%3D0.00007710&chs=400x400&cht=qr&choe=UTF-8&chld=L%7C0\",\n            \"rate\": \"648512\",\n            \"reference\": {},\n            \"region\": \"PH\",\n            \"settlement_detail\": {\n                \"actual_deposit_amount\": \"0\",\n                \"confirmation_code\": \"\",\n                \"delivered_by\": \"\",\n                \"notes\": \"\",\n                \"type\": \"\"\n            },\n            \"settlements\": [],\n            \"source_account_currency\": null,\n            \"source_client\": \"\",\n            \"status\": \"pending\",\n            \"user_agent\": {\n                \"browser\": \"Other\",\n                \"device\": \"Other\",\n                \"platform\": \"Other\",\n                \"user_agent\": \"PostmanRuntime/7.15.0\"\n            },\n            \"user_id\": \"8d19da635203431fbb6786029115bfbb\",\n            \"user_uri\": \"https://coins.ph/sellorder/425f200a5e3c4ca7a8b83004aed7c7e2\",\n            \"wallet_address\": \"3QDLzerVjkRFooXJtd6ou1SJELPfK294Le\"\n        },\n","name":""}]},"params":[{"name":"sell_order_id","type":"string","default":"","desc":"ID of a particular sell order to retrieve. Optional.","required":false,"in":"path","ref":"","_id":"5d1d926899097801e262cbf8"}],"method":"get","settings":"5d2c16e9ab606a0056359c3c"},"next":{"description":"","pages":[]},"title":"sellorder","type":"endpoint","slug":"sellorder-retrieve","excerpt":"Retrieve an existing sellorder","body":"A sellorder represents a cashout, wherein users can send funds from their Coins wallet account to a preferred cashout option.\n\n## Lifecycle of a cash out\n\nA cash out undergoes several phases before cash is delivered to the recipient. The first stage is creating the sell order. At this stage, a sender's order will be funded by debiting his Coins wallet account. Once the funds are received by Coins, the cash out will proceed to a delivery stage. Finally, a cash out may either have a successful delivery or a failed delivery. In the event of a failed delivery, funds will be refunded back to the sender.\n\n### Sending funds to Coins\n\nThe `status` property of a cash out shows whether the funds from the sender are already received by coins. It may have one of the three following values:\n\n* **pending** - The payment is yet to be received from the sender.\n* **success** - Payment for the cash out was successfully received by coins.\n* **failed** - The maximum allowed time window to pay for the cash out has been reached. A cash out with a `failed` status is already expired and any funds sent to pay for the cash out will no longer transition the payment status.\n\nFurthermore, the `delivery_status` property provides a more granular view of the current order state. The following are its possible values:\n\n* **pending_payment** - The order has been initiated, but payment has not yet been received\n* **payment_received** - We have successfully received your payment, and will be processed accordingly\n* **expired** - The order has expired because the payment has not been received on time\n* **on_hold** - The order is currently being held temporarily, and is being reviewed on our end\n* **delivering** - The order is en route to your recipient, or is ready for claiming by your customer\n* **settlement_failed** -  A settlement method for the order has failed. At this stage, we may still attempt to process the order through other methods. If there are no other options to settle, the order will be processed for refund.\n* **refunding** - We’re in the process of refunding the payment to your account\n* **refunded** - The money has been returned to your account\n* **settled** - The payment for the order has been successfully completed\n\nAside from `status` and `delivery_status`, the received payments can also be seen in the `payments` property, which is an array of all the payments received for the cash out. A payment has the following properties:\n\n* **transaction_type** - Indicates whether the payment was from an external `blockchain` transaction, or an `internal` Coins transaction. Examples of `blockchain` payments are those settled with an external service, while examples of `internal` transactions are those settled with a Coins wallet.\n* **transaction_ref** - Contains the transaction ID for `blockchain` payments. For `internal` payments, it contains the [payment ID](doc:crypto-payments).\n\n### Refund\n\nIt is possible that a cash out may fail delivery. For example, a pick up outlet may reject a cash out if the provided details are incorrect (ie. the given recipient address does not match the recipient's ID, etc.). Payment made for these cash outs will then be refunded back to the sender. Our operations and support team will then contact the sender to tell them the reason why the cash out needed to be refunded.\n\n* **is_refunded** - A property of the cash out which denotes whether the cash out has been refunded or not.\n\n### Delivery\n\nA successfully delivered cash out may have claiming details in order for the recipient to receive the funds. For example, pawnshops require the recipient to present a claiming number, and the name of the person who delivered the funds. This information can be found at the `settlement_detail` of a cash out. Additionally, settlement history can be found at the `settlements` array of a cash out. Settlements are representations of payment/s made by coins to the recipient of a cash out.\n\n#### settlement_detail\n\nCash out options that require claiming details will have this property filled up. For cash out options that do not require claiming details (ie. `bank`), this will usually be empty.\n\n* **actual_deposit_amount** - The amount that the recipient will receive with fees already deducted, if any.\n* **confirmation_code** -  A claiming code which the recipient needs to present to the pick up option in order to claim funds from the cash out.\n* **delivered_by** - Name of the person who delivered the cash out to a pick up option. This is usually required by pawnshops.\n*  **notes** - Additional notes that a recipient may need to know in order to claim funds from the cash out.\n\n#### settlements\n\nThis array contains the history of settlements made by coins to the recipient. A settlement object has the following properties:\n\n* **currency** - ISO 4217 currency code of the settlement's amount.\n* **amount** - The amount delivered by coins for the recipient.\n* **id** - The settlement's unique identifier.\n* **settled_at** - Date when the payment has been delivered in unix epoch.\n\n### Refund\n\nIt is possible that a cash out may fail delivery. For example, a pick up outlet may reject a cash out if the provided details are incorrect (ie. the given recipient address does not match the recipient's ID, etc.). Payment made for these cash outs will then be refunded back to the sender. Our operations and support team will then contact the sender to tell them the reason why the cash out needed to be refunded.\n\n* **is_refunded** - A property of the cash out which denotes whether the cash out has been refunded or not.","updates":[],"order":2,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5d1d926899097801e262cbf7","version":{"version":"2.1","version_clean":"2.1.0","codename":"collector","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"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"],"_id":"56326e9cdf556c0d00cd08ca","project":"544fc17e698ab40800b4f891","releaseDate":"2015-10-29T19:08:12.724Z","__v":22,"createdAt":"2015-10-29T19:08:12.724Z"},"updatedAt":"2019-07-05T02:27:53.828Z","createdAt":"2019-07-04T05:45:12.227Z","project":"544fc17e698ab40800b4f891","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Cash Out","slug":"cash-out-1","order":17,"from_sync":false,"reference":true,"_id":"5d1d8f6b613fb90050d0d3e0","project":"544fc17e698ab40800b4f891","version":"56326e9cdf556c0d00cd08ca","isAPI":false,"createdAt":"2019-07-04T05:32:27.464Z","__v":0},"user":"5d19a13b5afcdf002d5b5a9d","__v":14,"parentDoc":null}

getsellorder

Retrieve an existing sellorder

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

sell_order_id:
string
ID of a particular sell order to retrieve. Optional.

Examples


Result Format


Documentation

A sellorder represents a cashout, wherein users can send funds from their Coins wallet account to a preferred cashout option. ## Lifecycle of a cash out A cash out undergoes several phases before cash is delivered to the recipient. The first stage is creating the sell order. At this stage, a sender's order will be funded by debiting his Coins wallet account. Once the funds are received by Coins, the cash out will proceed to a delivery stage. Finally, a cash out may either have a successful delivery or a failed delivery. In the event of a failed delivery, funds will be refunded back to the sender. ### Sending funds to Coins The `status` property of a cash out shows whether the funds from the sender are already received by coins. It may have one of the three following values: * **pending** - The payment is yet to be received from the sender. * **success** - Payment for the cash out was successfully received by coins. * **failed** - The maximum allowed time window to pay for the cash out has been reached. A cash out with a `failed` status is already expired and any funds sent to pay for the cash out will no longer transition the payment status. Furthermore, the `delivery_status` property provides a more granular view of the current order state. The following are its possible values: * **pending_payment** - The order has been initiated, but payment has not yet been received * **payment_received** - We have successfully received your payment, and will be processed accordingly * **expired** - The order has expired because the payment has not been received on time * **on_hold** - The order is currently being held temporarily, and is being reviewed on our end * **delivering** - The order is en route to your recipient, or is ready for claiming by your customer * **settlement_failed** - A settlement method for the order has failed. At this stage, we may still attempt to process the order through other methods. If there are no other options to settle, the order will be processed for refund. * **refunding** - We’re in the process of refunding the payment to your account * **refunded** - The money has been returned to your account * **settled** - The payment for the order has been successfully completed Aside from `status` and `delivery_status`, the received payments can also be seen in the `payments` property, which is an array of all the payments received for the cash out. A payment has the following properties: * **transaction_type** - Indicates whether the payment was from an external `blockchain` transaction, or an `internal` Coins transaction. Examples of `blockchain` payments are those settled with an external service, while examples of `internal` transactions are those settled with a Coins wallet. * **transaction_ref** - Contains the transaction ID for `blockchain` payments. For `internal` payments, it contains the [payment ID](doc:crypto-payments). ### Refund It is possible that a cash out may fail delivery. For example, a pick up outlet may reject a cash out if the provided details are incorrect (ie. the given recipient address does not match the recipient's ID, etc.). Payment made for these cash outs will then be refunded back to the sender. Our operations and support team will then contact the sender to tell them the reason why the cash out needed to be refunded. * **is_refunded** - A property of the cash out which denotes whether the cash out has been refunded or not. ### Delivery A successfully delivered cash out may have claiming details in order for the recipient to receive the funds. For example, pawnshops require the recipient to present a claiming number, and the name of the person who delivered the funds. This information can be found at the `settlement_detail` of a cash out. Additionally, settlement history can be found at the `settlements` array of a cash out. Settlements are representations of payment/s made by coins to the recipient of a cash out. #### settlement_detail Cash out options that require claiming details will have this property filled up. For cash out options that do not require claiming details (ie. `bank`), this will usually be empty. * **actual_deposit_amount** - The amount that the recipient will receive with fees already deducted, if any. * **confirmation_code** - A claiming code which the recipient needs to present to the pick up option in order to claim funds from the cash out. * **delivered_by** - Name of the person who delivered the cash out to a pick up option. This is usually required by pawnshops. * **notes** - Additional notes that a recipient may need to know in order to claim funds from the cash out. #### settlements This array contains the history of settlements made by coins to the recipient. A settlement object has the following properties: * **currency** - ISO 4217 currency code of the settlement's amount. * **amount** - The amount delivered by coins for the recipient. * **id** - The settlement's unique identifier. * **settled_at** - Date when the payment has been delivered in unix epoch. ### Refund It is possible that a cash out may fail delivery. For example, a pick up outlet may reject a cash out if the provided details are incorrect (ie. the given recipient address does not match the recipient's ID, etc.). Payment made for these cash outs will then be refunded back to the sender. Our operations and support team will then contact the sender to tell them the reason why the cash out needed to be refunded. * **is_refunded** - A property of the cash out which denotes whether the cash out has been refunded or not.