Create payment

POST

/api/v1/payments

Create payment transaction

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Example

{
    "amount": 0.01,
    "currency": "USD",
    "order_id": "string",
    "service": "bank_card",
    "customer": {
        "name": "string",
        "email": "string",
        "phone": "+11234567890",
        "ip": "string"
    },
    "return_urls": {
        "fail": "string",
        "success": "string"
    },
    "webhook_url": "string",
    "bank_card": {
        "pan": "4242424242424242",
        "cvv": "123",
        "expire_date": "04/2030",
        "card_holder": "string"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://payments-api.xbillion.pro/api/v1/payments' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 0.01,
    "currency": "USD",
    "order_id": "string",
    "service": "bank_card",
    "customer": {
        "name": "string",
        "email": "string",
        "phone": "+11234567890",
        "ip": "string"
    },
    "return_urls": {
        "fail": "string",
        "success": "string"
    },
    "webhook_url": "string",
    "bank_card": {
        "pan": "4242424242424242",
        "cvv": "123",
        "expire_date": "04/2030",
        "card_holder": "string"
    }
}'

Responses

🟢200Payment creation result.

application/json

Body

Example

🟠400Bad request

🟠401Merchant is unauthorized.

🟠422Request for payment creation rejected by the payment system.

🔴500Internal error.

Get information