create payment

POST

https://api.freedompay.uz/v5/g2g/create

Request

Header Params

Body Params application/json

Example

{
    "amount": 10,
    "currency": "KZT",
    "description": "description",
    "order_id": "1234",
    "user_id": "12345",
    "auto_clearing": false,
    "from": {
        "type": "card",
        "card": {
            "name": "Test Test",
            "pan": "4400444400004440",
            "cvc": "123",
            "year": 24,
            "month": 8
        },
        "recurrent": {
            "lifetime": 1
        }
    },
    "device": {
        "user_ip": "84.252.158.239"
    },
    "urls": {
        "check_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e",
        "result_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.uz/v5/g2g/create' \
--header 'X-JWS-Signature: {{tmp_jws_signature}}' \
--header 'X-Action: gateway.payment.create' \
--header 'X-Request-Id: {{$randomUUID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 10,
    "currency": "KZT",
    "description": "description",
    "order_id": "1234",
    "user_id": "12345",
    "auto_clearing": false,
    "from": {
        "type": "card",
        "card": {
            "name": "Test Test",
            "pan": "4400444400004440",
            "cvc": "123",
            "year": 24,
            "month": 8
        },
        "recurrent": {
            "lifetime": 1
        }
    },
    "device": {
        "user_ip": "84.252.158.239"
    },
    "urls": {
        "check_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e",
        "result_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e"
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "id": "12cc1a13-3d44-4417-b700-039d979723d6",
    "status": "process",
    "amount": 100,
    "created_at": "2024-08-21T10:37:32.687Z"
}

🟠400Bad Request

🟠422Unprocessable Entity

Modified at 2025-02-03 10:55:01

Introduction

create payment recurrent