Skip to main content
POST
/
payments
Create a payment
curl --request POST \
  --url https://commerce1.on-hellgate.dev/payments \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "amount": 123,
  "currency_code": "<string>",
  "order_id": "<string>",
  "additional_information": {},
  "continuation": {
    "error": "<string>",
    "success": "<string>"
  },
  "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "distributions": [
    {
      "amount": 123,
      "description": "<string>",
      "seller_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "metadata": {},
  "payment_method": {
    "token": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "FIRST_PAYMENT"
  },
  "vault_payment_method": true
}
'
{
  "additional_information": {},
  "amount": 123,
  "continuation": {
    "error": "<string>",
    "success": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "currency": "<string>",
  "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "distributions": [
    {
      "amount": 123,
      "description": "<string>",
      "seller_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "metadata": {},
  "order_id": "<string>",
  "payment_method": {
    "created_at": "2023-11-07T05:31:56Z",
    "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "data": {},
    "holder": "<string>",
    "status": "<string>",
    "token": "<string>",
    "type": "CARD"
  },
  "processing": {
    "requirement": {
      "action": "<string>",
      "message": "<string>",
      "options": [
        {}
      ]
    },
    "status": "ACTION_REQUIRED"
  },
  "processor": {
    "amount_authorized": 123,
    "amount_captured": 123,
    "amount_refunded": 123,
    "merchant_id": "<string>",
    "name": "<string>"
  },
  "refunds": [
    {
      "amount": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "currency_code": "<string>",
      "distributions": [
        {
          "amount": 123,
          "description": "<string>",
          "seller_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ],
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "<string>"
    }
  ],
  "settlements": [
    {
      "amount": 123,
      "currency_code": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "settlement_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "settlement_report_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "<string>"
    }
  ],
  "status": "OPEN",
  "transactions": [
    {
      "amount": 123,
      "ended_at": "2023-11-07T05:31:56Z",
      "failure_reasons": [
        {
          "classifier": "<string>",
          "message": "<string>"
        }
      ],
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "processor_name": "<string>",
      "processor_transaction_id": "<string>",
      "started_at": "2023-11-07T05:31:56Z",
      "status": "PENDING",
      "transaction_type": "AUTHORIZE"
    }
  ]
}

Authorizations

X-API-Key
string
header
required

Headers

X-Idempotency-Key
string

Idempotency key

Body

application/json

Body

amount
integer
required
currency_code
string
required
order_id
string
required
additional_information
object
continuation
object
customer_id
string<uuid>
distributions
object[]
metadata
object
payment_method
object
vault_payment_method
boolean

Response

Success

additional_information
object
amount
integer
continuation
object
created_at
string<date-time>
currency
string
customer_id
string<uuid>
distributions
DistributionResponse · object[]
id
string<uuid>
metadata
object
order_id
string
payment_method
PaymentMethodResponse · object
processing
ProcessingResponse · object
processor
ProcessorResponse · object
refunds
RefundResponse · object[]
settlements
SettlementResponse · object[]
status
enum<string>
Available options:
OPEN,
AUTHORIZED,
ACCEPTED,
FAILED,
COMPLETED,
VOIDED
transactions
TransactionResponse · object[]