Skip to content

Create payment

POST api/v2/paygate/payment/card/
 Create a payment by card

Request Header

Field Type Required Description
X-Idempotency-Key string No Optional idempotency key for payment creation. Requests with the same API key, idempotency key, action and JSON body replay the original status and response for 24 hours.

Request Body schema

application/json

Field Type Required Description Example
endpoint string Yes Api key "53a90966-3640-486c-aa84-37aa8817abed"
amount integer Yes Amount in minor units 1000
currency integer Yes Number code 484
buyer object Yes Buyer at the endpoint in JSON format {"remote_id": "string", "ip": "string"}
description string No Description "string"
client_id string No Transaction id at the endpoint.
Max 255 chars		 "string"
success_url string or null No Redirect URL after success result "http://example.com"
fail_url string or null No Redirect URL after fail result "http://example.com"
notify_url string or null No Notification URL of changed status "http://example.com"
name string Yes The customer's name "John Smith"
email string Yes The customer's email "user@example.com"
phone string No The customer's phone(must follow E.164 format) "+52999999999"

Request sample

{
    "endpoint": "53a90966-3640-486c-aa84-37aa8817abed",
    "amount": 1000,
    "currency": 484,
    "buyer": {
        "remote_id": "string",
        "ip": "string"
    },
    "description": "string",
    "client_id": "string",
    "success_url": "http://example.com",
    "fail_url": "http://example.com",
    "notify_url": "http://example.com",
    "name": "John Smith",
    "email": "user@example.com",
    "phone": "+52999999999"
}

Response sample


STATUS 201

{
    "redirect_url": "http://example.com",
    "info": {
        "tx": "f17d7f5c-6b4a-47fd-95eb-08086e250473",
        "payment": {},
        "status": "create",
        "currency": {
          "id": 0,
          "title": "MXN",
          "char_code": "MXN",
          "num_code": 484
        },
        "amount": 1000,
        "created_at": "2000-01-01T00:00:00Z",
        "errors": {},
        "parts_tx": [],
        "additional_data": {},
        "endpoint_logo": "string"
    },
    "qr_code": {
        "qrcode": "string",
        "beneficiary": "string",
        "format": "string",
        "copypaste": "string"
    },
    "p2p_wallet_data": {
        "target_account_number": "string",
        "bank_name": "string",
        "holder": "string",
        "valid_till": "2000-01-01T00:00:00Z",
        "tll": "00:00:00Z"
    },
    "p2p_card_data": {
        "target_card_number": "string",
        "bank_name": "string",
        "holder": "string",
        "valid_till": "2000-01-01T00:15:00Z",
        "tll": "00:15:00Z"
    },
    "pay_data": "string"
}