Payments API: slikair Payments API V2

Method	Path	Summary	operationId
POST	/payment/create	Create Payment	createPaymentV2
POST	/payment/get-status	Get Payment Status	getPaymentStatusV2

POST/payment/create

Create Payment

operationId: createPaymentV2

Initiates a payment transaction. The request structure varies by payment_method.

Required headers

merchant-tokenContent-TypeIdempotency-Key

Request body

Payment create request

Example variants

credit_cardcryptoopen_bankingblikgooglepayapplepayinterac

Responses

200	Payment create response
400	Error response
401	Error response
500	Error response

Example: credit_card

curl -X POST https://devsilo.xyz/api/v2/payment/create \
  -H "merchant-token: $SLIKAIR_MERCHANT_TOKEN" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_id": "9e07802d51264b02b4b3ef09dfb94219",
    "merchant_site_id": "1234",
    "payment_method": "credit_card",
    "device_ip": "203.0.113.10",
    "amount": 99.99,
    "currency": "EUR",
    "email": "john.doe@example.com",
    "request_id": "order-1001",
    "country": "NLD",
    "first_name": "John",
    "last_name": "Doe",
    "notification_link": "https://example.com/webhook",
    "success_url": "https://example.com/success",
    "pending_url": "https://example.com/pending",
    "fail_url": "https://example.com/fail",
    "back_url": "https://example.com/cart",
    "mobile": "+31600000000",
    "address": "Main Street 1",
    "city": "Amsterdam",
    "zipCode": "1011AB",
    "state": "NH",
    "birthDate": "1990-01-01",
    "cardNum": "4111111111111111",
    "cardHolder": "John Doe",
    "cardExpireMonth": "12",
    "cardExpireYear": "2030",
    "cardCvv": "123"
  }'

Request body fields

Payment create request27 fields

Field	Required	Type	Description	Example
merchant_id	required	string	Merchant identifier from Integration settings.
merchant_site_id	required	string	Site identifier from Integration settings.
payment_method	required	enum	One of the supported V2 payment methods.	credit_card
amount	required	number	2 decimals for fiat, up to 10 decimals for crypto.	99.99
currency	required	string	ISO 4217 currency code.	EUR
email	required	string	Customer email address.
request_id	required	string	Unique merchant reference for the attempt.
country	required	string	ISO 3166-1 alpha-3 country code.	NLD
notification_link	required	string (uri)	Webhook URL for the pay-in notification.
success_url	required	string (uri)	Redirect on success.
pending_url	required	string (uri)	Redirect while pending.
fail_url	required	string (uri)	Redirect on failure.
back_url	required	string (uri)	Redirect when the customer goes back.
device_ip	required	string	Customer device IP address.
first_name	required	string
last_name	required	string
mobile	optional	string	Required for credit_card, credit_card_ftd, interac, blik, googlepay, applepay.
address	optional	string	Required for credit_card, credit_card_ftd, interac, googlepay, applepay.
city	optional	string	Required for the same methods as address.
zipCode	optional	string	Required for the same methods as address.
state	optional	string	Required for credit_card, credit_card_ftd, googlepay, applepay.
birthDate	optional	string	Required for the same methods as state.
cardNum	optional	string	Required for credit_card and credit_card_ftd.
cardHolder	optional	string	Required for credit_card and credit_card_ftd.
cardExpireMonth	optional	string	Required for credit_card and credit_card_ftd.
cardExpireYear	optional	string	Required for credit_card and credit_card_ftd.
cardCvv	optional	string	Required for credit_card and credit_card_ftd.

Response body fields

200Payment create response6 fields

Field	Required	Type	Description
status	optional	enum	success \| failed
status_code	optional	integer
request_id	optional	uuid / string
payin_id	optional	uuid
redirect_url	optional	string (uri)
created_at	optional	string (date-time)

400401500Error response8 fields

Field	Required	Type	Description
status	optional	enum	error
status_code	optional	integer
reason_code	optional	string
error_code	optional	string	5 digits
request_id	optional	uuid / string
message	optional	string
payin_id	optional	uuid \| null
details	optional	object	Field validation errors.

POST/payment/get-status

Get Payment Status

operationId: getPaymentStatusV2

Retrieves the current status of a payment transaction.

Required headers

merchant-tokenContent-Type

Request body

Payment status request

Responses

200	Payment status response
400	Error response	Validation error
401	Error response	Unauthorized

Example request

{
  "merchant_id": "9e07802d51264b02b4b3ef09dfb94219",
  "payin_id": "b0f8f0f4-1f5d-4d1a-8f0e-9c1d2e3f4a5b"
}

Request body fields

Payment status request2 fields

Field	Required	Type	Description	Example
merchant_id	required	string
payin_id	required	uuid	Payment identifier returned on create.

Response body fields

200Payment status response7 fields

Field	Required	Type	Description
status	optional	enum	initiated \| processing \| succeeded \| failed \| kyc_required \| refunded \| chargeback
status_code	optional	integer
payin_id	optional	uuid
request_id	optional	string
payment_method	optional	string
amount	optional	number
currency	optional	string

400401Error responseValidation error8 fields

Field	Required	Type	Description
status	optional	enum	error
status_code	optional	integer
reason_code	optional	string
error_code	optional	string	5 digits
request_id	optional	uuid / string
message	optional	string
payin_id	optional	uuid \| null
details	optional	object	Field validation errors.