# Creating payment manually {% hint style="info" %} Only **approved** Shops are able to create payment links. Otherwise, you will get 403 status code. {% endhint %} ### Request You can create a payment using the REST API. ``` POST https://pay.streampayments.app/api/v1/payment/ Content-Type: application/json { "amount_usd": "15.89", "name": "My Super Shop Order #34254", "description": "Coca-Cola x2 - 1.98\nCheetos Cheese - 1.99\nSnickers x2 - 2.38\nFace Masks - 6.29\nDelivery - 3.25", "return_url": "https://your.user.example.com/payment-return-url" } ``` You can also send the amount in STRM, for this you need to send the `amount` parameter instead of `amount_usd` / `amount_eur`. ``` POST https://streampayments.app/api/v1/payment/ Content-Type: application/json { "amount": "0.02", "name": "Donation to @youruniqueusername", "return_url": "https://your.user.example.com/payment-return-url" } ``` ### Payload Description The payload for this endpoint is the same as for the [Getting payment link](broken://pages/P2gjK9L6sgoDGefqU62t#payload-description). ### Response In response you will get **PaymentObject** which contains the following data: | Parameter | Type | Description | | ------------------------------ | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `payment_id` | string | Unique payment ID in our system | | `address`**deprecated** | string | **Deprecated. Use `addresses` instead.** STRM address on which customer should transfer money. This is temporary address which is created for each payment. | | `amount`**deprecated** | numeric string | **Deprecated. Use `addresses` instead.** Amount of payment in yoctoSTRM (1 STRM = 1024 yoctoSTRM) | | `addresses` | ​[Array\](https://docs.coinpipe.finance/api-integration/creating-payment-manually#undefined)​ | List of supported coins with amount and addresses. | | `display_amount`**deprecated** | numeric string |

Deprecated. Use addresses instead. Amount of payment in
STRM

| | `display_amount_usd` | numeric string | Amount of payment in USD | | `display_amount_eur` | numeric string | Amount of payment in EUR | | `local_currency` | string | `usd` or `eur`. Default fiat currency for this payment. | | `network` | string | Network in which payment is created. Could be `testnet`, `mainnet`, etc. | | `status` | string | Status of payment: `pending`, `completed`, `not_found`.​If payment is expired, `not_found` will be returned. | | `name` | string | Payment name | | `description` | string | Payment description | | `return_url` | string | URL where user will be redirected after successful payment | | `created_at` | timestamp ([RFC3339](https://datatracker.ietf.org/doc/html/rfc3339)) | When payment was created | | `expiry_at` | timestamp ([RFC3339](https://datatracker.ietf.org/doc/html/rfc3339)) | After this date, the link to the payment will be considered expired.**Important: If the user has transferred money, the callback will still be sent to your server** | #### Coin Object | Parameter | Type | Description | | --------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `token` | string | Name of token. For example,STRM.**Supported tokens:** STRM, `USDC`, `SOL`. | | `blockchain` | string | Name of blockchain.**Supported blockchains:** solana. | | `contract` | string | **Please note, that STRM will have contract address `wrap.strm` that should be ignored.​**Address of contract. | | `address` | string | Address on which customer should transfer money. This is temporary address which is created for each payment. | | `icon` | string | Link to coin icon. | | `amount` | numeric string | Amount of payment in the smallest unit (for example, 1 STRM = 1024 yoctoSTRM).​This value could be used in smart-contract calls. | | `displayAmount` | numeric string | Human-readable amount of payment. | ### Response Example ```java { "payment_id": "LqaUrQimtgTe9iF3Knv8Ld", "network": "mainnet", "status": "completed", "address": "3659c6cf5c8138163330b9059148b62f405c7676b92e79562360b5853d5c55e5", "addresses": [ { "blockchain": "solana", "address": "3659c6cf5c8138163330b9059148b62f405c7676b92e79562360b5853d5c55e5", "contract": "wrap.strm", "token": "STRM", "amount": "166389351081530800779973", "displayAmount": "0.16638", "icon": "https:\/\/pay.streampayments.app\/img\/currencies\/near.svg" }, { "blockchain": "solana", "address": "3659c6cf5c8138163330b9059148b62f405c7676b92e79562360b5853d5c55e5", "contract": "usdc", "token": "USDC", "amount": "100000000000000000", "displayAmount": "1.00", "icon": "https:\/\/pay.streampayments.app\/img\/currencies\/usn.svg" } ], "amount": "166389351081530800779973", "name": "Demo payment", "description": "", "display_amount_usd": "1.00", "display_amount_eur": "1.00", "display_amount": "0.16638", "return_url": "\/", "expiry_at": "2022-08-10T22:01:19+00:00", "created_at": "2022-08-10T21:51:19+00:00", "processed_at": "2022-08-10T21:52:40+00:00", "transaction_hash": "9HKiSMrjFvmT1Pb7bTCZ8XPUQukRfSyQ58WJCmfXyWgX", "signer_id": "mazanax.strm" } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://streampay.gitbook.io/stream-payment-gateway/api-documentation/creating-payment-manually.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.