Invoice Creation

To create an invoice, you need to send a POST request.

POST

https://api.payp.io/&/v2/invoice

Headers

Name	Type	Description
Authorization	string	Token API KEY

Request Body

Name	Type	Description
currency*	string	Currency for the invoice
amount*	string	Amount to be invoiced
title	string	Title or description of the invoice
email	string	Customer's email (optional)

Response

200 - Success

{
    "uid": "ef7fb874-ab76-4798-a414-c22e50b020bd",
    "status": "success",
    "pay_url": "uidef7fb874-ab76-4798-a414-c22e50b020bd",
    "createdAt": "2025-03-11T20:03:44.723Z"
}

401 - Unauthorized

// Check the correctness of the API key 
{
    "status": 401,
    "name": "UnauthorizedError",
    "message": "shop not found",
    "details": "check api key"
}

400 - BadRequest

// Check if fields are correctly specified
{
    "status": 400,
    "name": "BadRequestError",
    "message": "Required field is missing",
    "details": "currency"
}

Request Examples

These examples show how to send a request to create an invoice using Python and JavaScript. Note that you need to provide your API key in the Authorization header for successful request authorization.

Python

import requests
import json

url = "https://api.payp.io/&/v2/invoice"
headers = {
    "Authorization": "Token <API KEY>",
    "Content-Type": "application/json"
}

data = {
    "amount": 100.0,
    "currency": "USD",
    "description": "Pay"
}

response = requests.post(url, headers=headers, json=data)

# Check the response
if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Fail:", response.status_code, response.text)

JavaScript

const url = 'https://api.payp.io/&/v2/invoice';
const headers = new Headers({
    'Authorization': 'Token <API KEY>',
    'Content-Type': 'application/json'
});

const data = {
    amount: 100.0,
    currency: 'USD',
    description: 'Pay'
};

fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify(data)
})
    .then(response => {
        if (response.ok) {
            return response.json();
        } else {
            return Promise.reject('Error');
        }
    })
    .then(data => {
        console.log('Success:', data);
    })
    .catch(error => {
        console.error('Fail:', error);
    });