⏺️Request New Payment (web page)

To initiate a new payment request using the CoinbarPay API, you will need to provide specific parameters and call the appropriate endpoint.

Upon successfully processing this request, the CoinbarPay API will return a payment request token that you can use to initiate the payment process through the CoinbarPay Web Gateway, as described in the "Payment Flow" topic.

Create request token

To make the API request, use the following :

Generate a new payment request token

POST https://sandbox.coinbar.io/coinbar/api/v2/pay/gateway/request

Headers

Name	Type	Description
CBPAY-API-KEY*	String	{{SERVICE_CLIENT_ID}}
Content-Type*	String	application/json
SIGNATURE*	String	{{SIGNATURE_TOKEN}} HMAC SHA-256 body validation
source*	String	String "web"

Request Body

Name	Type	Description
service_client_id*	String	{{SERVICE_CLIENT_ID}}
payment_request_id*	String	Generated by Your application
input_coin*	String	"EUR"
products*	Array	Products, can be provided products details or just one product with total billing receipt. See the section below for more details
email*	String	Customer email
surname	String	Customer Last Name
name	String	Customer Name
user_id*	String	Generated by Your application
timestamp*	Number	TIMESTAMP of your request in milliseconds
urlcallback	String	Custom webhook -- obslolete parameter

200: OK

{
    "result": "success",
    "request_token": "WlpZSkE3d3ZKa2NSTTl0VHNKTT....",
    "url_example": "?requestToken=WlpZSkE3d3ZKa2NSTTl0VHNKTTF...."
}

Products body element:

Here's an example of products JSON body parameter :

"products": [
    {
      "product_name": "Product 1",
      "product_price": 1.99,
      "product_amount": 1,
      "product_id": "id1",
      "product_type": "general"
    },
    {
      "product_name": "Product 2",
      "product_price": 0.99,
      "product_amount": 2,
      "product_id": "id2",
      "product_type": "general"
    }
]

Valid response will contain request_token , that will be used to call the Payment Gateway