Skip to main content
POST
/
v1
/
transactions
Ingest transactions into the system
curl --request POST \
  --url https://api.slickerhq.com/ingest/v1/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactions": [
    {
      "id": "txn_12345678",
      "paymentGatewayTransactionId": "ch_1a2b3c4d5e",
      "state": "TRANSACTION_STATE_PAID",
      "customerId": "cus_87654321",
      "subscriptionId": "sub_12345678",
      "invoiceId": "inv_12345678",
      "businessEntity": "ACME Inc.",
      "amount": 2500,
      "currency": "USD",
      "createdAt": "2023-01-15T10:15:00Z",
      "updatedAt": "2023-01-15T10:20:00Z",
      "paymentMethodType": "card",
      "paymentGatewayId": "pg_stripe",
      "paymentGatewayName": "Stripe",
      "paymentGatewayType": "credit_card",
      "paymentGatewayStatus": "succeeded",
      "cardBrand": "visa",
      "cardBin": "411111",
      "cardFingerprint": "Xt5EWLLDS7FJjR1c",
      "cardCountry": "US"
    },
    {
      "id": "txn_87654321",
      "paymentGatewayTransactionId": "ch_5e4d3c2b1a",
      "state": "TRANSACTION_STATE_FAILED",
      "customerId": "cus_12345678",
      "subscriptionId": "sub_87654321",
      "invoiceId": "inv_87654321",
      "businessEntity": "ACME Inc.",
      "amount": 5000,
      "currency": "USD",
      "createdAt": "2023-01-20T09:15:00Z",
      "updatedAt": "2023-01-20T09:20:00Z",
      "paymentMethodType": "card",
      "paymentGatewayId": "pg_stripe",
      "paymentGatewayName": "Stripe",
      "paymentGatewayType": "credit_card",
      "paymentGatewayStatus": "failed",
      "paymentGatewayErrorCode": "card_declined",
      "paymentGatewayErrorMessage": "Your card was declined",
      "cardBrand": "mastercard",
      "cardBin": "511111",
      "cardFingerprint": "R7GsJL9FmKj3dN2q",
      "cardCountry": "UK"
    }
  ]
}
'
import requests

url = "https://api.slickerhq.com/ingest/v1/transactions"

payload = { "transactions": [
        {
            "id": "txn_12345678",
            "paymentGatewayTransactionId": "ch_1a2b3c4d5e",
            "state": "TRANSACTION_STATE_PAID",
            "customerId": "cus_87654321",
            "subscriptionId": "sub_12345678",
            "invoiceId": "inv_12345678",
            "businessEntity": "ACME Inc.",
            "amount": 2500,
            "currency": "USD",
            "createdAt": "2023-01-15T10:15:00Z",
            "updatedAt": "2023-01-15T10:20:00Z",
            "paymentMethodType": "card",
            "paymentGatewayId": "pg_stripe",
            "paymentGatewayName": "Stripe",
            "paymentGatewayType": "credit_card",
            "paymentGatewayStatus": "succeeded",
            "cardBrand": "visa",
            "cardBin": "411111",
            "cardFingerprint": "Xt5EWLLDS7FJjR1c",
            "cardCountry": "US"
        },
        {
            "id": "txn_87654321",
            "paymentGatewayTransactionId": "ch_5e4d3c2b1a",
            "state": "TRANSACTION_STATE_FAILED",
            "customerId": "cus_12345678",
            "subscriptionId": "sub_87654321",
            "invoiceId": "inv_87654321",
            "businessEntity": "ACME Inc.",
            "amount": 5000,
            "currency": "USD",
            "createdAt": "2023-01-20T09:15:00Z",
            "updatedAt": "2023-01-20T09:20:00Z",
            "paymentMethodType": "card",
            "paymentGatewayId": "pg_stripe",
            "paymentGatewayName": "Stripe",
            "paymentGatewayType": "credit_card",
            "paymentGatewayStatus": "failed",
            "paymentGatewayErrorCode": "card_declined",
            "paymentGatewayErrorMessage": "Your card was declined",
            "cardBrand": "mastercard",
            "cardBin": "511111",
            "cardFingerprint": "R7GsJL9FmKj3dN2q",
            "cardCountry": "UK"
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transactions: [
      {
        id: 'txn_12345678',
        paymentGatewayTransactionId: 'ch_1a2b3c4d5e',
        state: 'TRANSACTION_STATE_PAID',
        customerId: 'cus_87654321',
        subscriptionId: 'sub_12345678',
        invoiceId: 'inv_12345678',
        businessEntity: 'ACME Inc.',
        amount: 2500,
        currency: 'USD',
        createdAt: '2023-01-15T10:15:00Z',
        updatedAt: '2023-01-15T10:20:00Z',
        paymentMethodType: 'card',
        paymentGatewayId: 'pg_stripe',
        paymentGatewayName: 'Stripe',
        paymentGatewayType: 'credit_card',
        paymentGatewayStatus: 'succeeded',
        cardBrand: 'visa',
        cardBin: '411111',
        cardFingerprint: 'Xt5EWLLDS7FJjR1c',
        cardCountry: 'US'
      },
      {
        id: 'txn_87654321',
        paymentGatewayTransactionId: 'ch_5e4d3c2b1a',
        state: 'TRANSACTION_STATE_FAILED',
        customerId: 'cus_12345678',
        subscriptionId: 'sub_87654321',
        invoiceId: 'inv_87654321',
        businessEntity: 'ACME Inc.',
        amount: 5000,
        currency: 'USD',
        createdAt: '2023-01-20T09:15:00Z',
        updatedAt: '2023-01-20T09:20:00Z',
        paymentMethodType: 'card',
        paymentGatewayId: 'pg_stripe',
        paymentGatewayName: 'Stripe',
        paymentGatewayType: 'credit_card',
        paymentGatewayStatus: 'failed',
        paymentGatewayErrorCode: 'card_declined',
        paymentGatewayErrorMessage: 'Your card was declined',
        cardBrand: 'mastercard',
        cardBin: '511111',
        cardFingerprint: 'R7GsJL9FmKj3dN2q',
        cardCountry: 'UK'
      }
    ]
  })
};

fetch('https://api.slickerhq.com/ingest/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.slickerhq.com/ingest/v1/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transactions' => [
        [
                'id' => 'txn_12345678',
                'paymentGatewayTransactionId' => 'ch_1a2b3c4d5e',
                'state' => 'TRANSACTION_STATE_PAID',
                'customerId' => 'cus_87654321',
                'subscriptionId' => 'sub_12345678',
                'invoiceId' => 'inv_12345678',
                'businessEntity' => 'ACME Inc.',
                'amount' => 2500,
                'currency' => 'USD',
                'createdAt' => '2023-01-15T10:15:00Z',
                'updatedAt' => '2023-01-15T10:20:00Z',
                'paymentMethodType' => 'card',
                'paymentGatewayId' => 'pg_stripe',
                'paymentGatewayName' => 'Stripe',
                'paymentGatewayType' => 'credit_card',
                'paymentGatewayStatus' => 'succeeded',
                'cardBrand' => 'visa',
                'cardBin' => '411111',
                'cardFingerprint' => 'Xt5EWLLDS7FJjR1c',
                'cardCountry' => 'US'
        ],
        [
                'id' => 'txn_87654321',
                'paymentGatewayTransactionId' => 'ch_5e4d3c2b1a',
                'state' => 'TRANSACTION_STATE_FAILED',
                'customerId' => 'cus_12345678',
                'subscriptionId' => 'sub_87654321',
                'invoiceId' => 'inv_87654321',
                'businessEntity' => 'ACME Inc.',
                'amount' => 5000,
                'currency' => 'USD',
                'createdAt' => '2023-01-20T09:15:00Z',
                'updatedAt' => '2023-01-20T09:20:00Z',
                'paymentMethodType' => 'card',
                'paymentGatewayId' => 'pg_stripe',
                'paymentGatewayName' => 'Stripe',
                'paymentGatewayType' => 'credit_card',
                'paymentGatewayStatus' => 'failed',
                'paymentGatewayErrorCode' => 'card_declined',
                'paymentGatewayErrorMessage' => 'Your card was declined',
                'cardBrand' => 'mastercard',
                'cardBin' => '511111',
                'cardFingerprint' => 'R7GsJL9FmKj3dN2q',
                'cardCountry' => 'UK'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slickerhq.com/ingest/v1/transactions"

	payload := strings.NewReader("{\n  \"transactions\": [\n    {\n      \"id\": \"txn_12345678\",\n      \"paymentGatewayTransactionId\": \"ch_1a2b3c4d5e\",\n      \"state\": \"TRANSACTION_STATE_PAID\",\n      \"customerId\": \"cus_87654321\",\n      \"subscriptionId\": \"sub_12345678\",\n      \"invoiceId\": \"inv_12345678\",\n      \"businessEntity\": \"ACME Inc.\",\n      \"amount\": 2500,\n      \"currency\": \"USD\",\n      \"createdAt\": \"2023-01-15T10:15:00Z\",\n      \"updatedAt\": \"2023-01-15T10:20:00Z\",\n      \"paymentMethodType\": \"card\",\n      \"paymentGatewayId\": \"pg_stripe\",\n      \"paymentGatewayName\": \"Stripe\",\n      \"paymentGatewayType\": \"credit_card\",\n      \"paymentGatewayStatus\": \"succeeded\",\n      \"cardBrand\": \"visa\",\n      \"cardBin\": \"411111\",\n      \"cardFingerprint\": \"Xt5EWLLDS7FJjR1c\",\n      \"cardCountry\": \"US\"\n    },\n    {\n      \"id\": \"txn_87654321\",\n      \"paymentGatewayTransactionId\": \"ch_5e4d3c2b1a\",\n      \"state\": \"TRANSACTION_STATE_FAILED\",\n      \"customerId\": \"cus_12345678\",\n      \"subscriptionId\": \"sub_87654321\",\n      \"invoiceId\": \"inv_87654321\",\n      \"businessEntity\": \"ACME Inc.\",\n      \"amount\": 5000,\n      \"currency\": \"USD\",\n      \"createdAt\": \"2023-01-20T09:15:00Z\",\n      \"updatedAt\": \"2023-01-20T09:20:00Z\",\n      \"paymentMethodType\": \"card\",\n      \"paymentGatewayId\": \"pg_stripe\",\n      \"paymentGatewayName\": \"Stripe\",\n      \"paymentGatewayType\": \"credit_card\",\n      \"paymentGatewayStatus\": \"failed\",\n      \"paymentGatewayErrorCode\": \"card_declined\",\n      \"paymentGatewayErrorMessage\": \"Your card was declined\",\n      \"cardBrand\": \"mastercard\",\n      \"cardBin\": \"511111\",\n      \"cardFingerprint\": \"R7GsJL9FmKj3dN2q\",\n      \"cardCountry\": \"UK\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.slickerhq.com/ingest/v1/transactions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transactions\": [\n    {\n      \"id\": \"txn_12345678\",\n      \"paymentGatewayTransactionId\": \"ch_1a2b3c4d5e\",\n      \"state\": \"TRANSACTION_STATE_PAID\",\n      \"customerId\": \"cus_87654321\",\n      \"subscriptionId\": \"sub_12345678\",\n      \"invoiceId\": \"inv_12345678\",\n      \"businessEntity\": \"ACME Inc.\",\n      \"amount\": 2500,\n      \"currency\": \"USD\",\n      \"createdAt\": \"2023-01-15T10:15:00Z\",\n      \"updatedAt\": \"2023-01-15T10:20:00Z\",\n      \"paymentMethodType\": \"card\",\n      \"paymentGatewayId\": \"pg_stripe\",\n      \"paymentGatewayName\": \"Stripe\",\n      \"paymentGatewayType\": \"credit_card\",\n      \"paymentGatewayStatus\": \"succeeded\",\n      \"cardBrand\": \"visa\",\n      \"cardBin\": \"411111\",\n      \"cardFingerprint\": \"Xt5EWLLDS7FJjR1c\",\n      \"cardCountry\": \"US\"\n    },\n    {\n      \"id\": \"txn_87654321\",\n      \"paymentGatewayTransactionId\": \"ch_5e4d3c2b1a\",\n      \"state\": \"TRANSACTION_STATE_FAILED\",\n      \"customerId\": \"cus_12345678\",\n      \"subscriptionId\": \"sub_87654321\",\n      \"invoiceId\": \"inv_87654321\",\n      \"businessEntity\": \"ACME Inc.\",\n      \"amount\": 5000,\n      \"currency\": \"USD\",\n      \"createdAt\": \"2023-01-20T09:15:00Z\",\n      \"updatedAt\": \"2023-01-20T09:20:00Z\",\n      \"paymentMethodType\": \"card\",\n      \"paymentGatewayId\": \"pg_stripe\",\n      \"paymentGatewayName\": \"Stripe\",\n      \"paymentGatewayType\": \"credit_card\",\n      \"paymentGatewayStatus\": \"failed\",\n      \"paymentGatewayErrorCode\": \"card_declined\",\n      \"paymentGatewayErrorMessage\": \"Your card was declined\",\n      \"cardBrand\": \"mastercard\",\n      \"cardBin\": \"511111\",\n      \"cardFingerprint\": \"R7GsJL9FmKj3dN2q\",\n      \"cardCountry\": \"UK\"\n    }\n  ]\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.slickerhq.com/ingest/v1/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transactions\": [\n    {\n      \"id\": \"txn_12345678\",\n      \"paymentGatewayTransactionId\": \"ch_1a2b3c4d5e\",\n      \"state\": \"TRANSACTION_STATE_PAID\",\n      \"customerId\": \"cus_87654321\",\n      \"subscriptionId\": \"sub_12345678\",\n      \"invoiceId\": \"inv_12345678\",\n      \"businessEntity\": \"ACME Inc.\",\n      \"amount\": 2500,\n      \"currency\": \"USD\",\n      \"createdAt\": \"2023-01-15T10:15:00Z\",\n      \"updatedAt\": \"2023-01-15T10:20:00Z\",\n      \"paymentMethodType\": \"card\",\n      \"paymentGatewayId\": \"pg_stripe\",\n      \"paymentGatewayName\": \"Stripe\",\n      \"paymentGatewayType\": \"credit_card\",\n      \"paymentGatewayStatus\": \"succeeded\",\n      \"cardBrand\": \"visa\",\n      \"cardBin\": \"411111\",\n      \"cardFingerprint\": \"Xt5EWLLDS7FJjR1c\",\n      \"cardCountry\": \"US\"\n    },\n    {\n      \"id\": \"txn_87654321\",\n      \"paymentGatewayTransactionId\": \"ch_5e4d3c2b1a\",\n      \"state\": \"TRANSACTION_STATE_FAILED\",\n      \"customerId\": \"cus_12345678\",\n      \"subscriptionId\": \"sub_87654321\",\n      \"invoiceId\": \"inv_87654321\",\n      \"businessEntity\": \"ACME Inc.\",\n      \"amount\": 5000,\n      \"currency\": \"USD\",\n      \"createdAt\": \"2023-01-20T09:15:00Z\",\n      \"updatedAt\": \"2023-01-20T09:20:00Z\",\n      \"paymentMethodType\": \"card\",\n      \"paymentGatewayId\": \"pg_stripe\",\n      \"paymentGatewayName\": \"Stripe\",\n      \"paymentGatewayType\": \"credit_card\",\n      \"paymentGatewayStatus\": \"failed\",\n      \"paymentGatewayErrorCode\": \"card_declined\",\n      \"paymentGatewayErrorMessage\": \"Your card was declined\",\n      \"cardBrand\": \"mastercard\",\n      \"cardBin\": \"511111\",\n      \"cardFingerprint\": \"R7GsJL9FmKj3dN2q\",\n      \"cardCountry\": \"UK\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body
{
  "requestId": "req_2uqkAo1bwllmzrgV2qtGv48DtGI"
}
{
  "code": 400,
  "message": "Invalid transaction data: missing required fields",
  "details": []
}
{
  "code": 401,
  "message": "Unauthorized: missing or invalid API key in Bearer token",
  "details": []
}
{
  "code": 403,
  "message": "Forbidden: insufficient permissions to ingest transactions",
  "details": []
}
{
  "code": 429,
  "message": "Rate limit exceeded: try again later",
  "details": []
}
{
  "code": 500,
  "message": "Internal server error",
  "details": []
}
{
  "requestId": "req_2uqkAo1bwllmzrgV2qtGv48DtGI"
}

Authorizations

​
Authorization
string
header
required

API key authentication using a Bearer token in the Authorization header. Example: Authorization: Bearer YOUR_API_KEY

Body

application/json

Request to ingest transaction data. Maximum of 200 transactions per request.

​
transactions
object[]

Response

A successful response.

​
requestId
string

Unique identifier for tracking the request through the system

Example:

"req_2uqkAo1bwllmzrgV2qtGv48DtGI"