Payment request

Generate a new payment request

post

Create a new payment request with a specified amount, redirecting to the given url

Authorizations

Body

amountstringOptionalExample: 100

currencystring · enumOptional

@enum USD

Possible values:

redirect_urlstringOptionalExample: https://example.com/redirect

reference_idstringOptionalExample: 1234567890

Responses

200

OK

application/json

400

Bad Request

application/json

422

Unprocessable Entity

application/json

post

HTTPcURLJavaScriptPython

POST /payments/request HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "amount": "100",
  "currency": "USD",
  "redirect_url": "https://example.com/redirect",
  "reference_id": "1234567890"
}

{
  "id": "text",
  "reference_id": "text",
  "status": "text",
  "url": "text"
}

Retrieve a payment request by id

get

Retrieves a payment request, together with its current status

Authorizations

Path parameters

idstringRequired

ID of the payment request

Responses

200

OK

application/json

400

Bad Request

application/json

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

GET /payments/request/{id} HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "reference_id": "text",
  "status": "text",
  "url": "text"
}