Payment request

Generate a new payment request

post

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

Authorizations

OAuth2ClientCredentials

OAuth2applicationRequired

Token URL:

Body

application/json

amountstringOptionalExample: 100

redirect_urlstringOptionalExample: https://example.com/redirect

reference_idstringOptionalExample: 1234567890

Responses

200

OK

application/json

idstringOptional

reference_idstringOptional

statusstringOptional

urlstringOptional

400

Bad Request

application/json

422

Unprocessable Entity

application/json

post

/payments/request

HTTPcURLJavaScriptPython

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

{
  "amount": "100",
  "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

OAuth2ClientCredentials

OAuth2applicationRequired

Token URL:

Path parameters

idstringRequired

ID of the payment request

Responses

200

OK

application/json

idstringOptional

reference_idstringOptional

statusstringOptional

urlstringOptional

400

Bad Request

application/json

404

Not Found

application/json

get

/payments/request/{id}

HTTPcURLJavaScriptPython

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

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