Mariana Tek Stripe Integration API v1.0.0

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

Here are the endpoints you need to integrate with Mariana via Stripe.

Email: Support

Authentication

• HTTP Authentication, scheme: bearer

Configuration

Get configuration values

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/configuration/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/configuration/ HTTP/1.1

Content-Type: application/json
Accept: application/json

const inputBody = '{
  "cart": 123
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/configuration/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/configuration/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/configuration/', headers = headers)

print(r.json())

 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/configuration/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/configuration/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/configuration/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/configuration/

Retrieve configuration values for Stripe.

Accepts both GET and POST requests. Returns information necessary to initialize Stripe on the frontend.

Optionally accepts a cart parameter. If one is specified, the response will include the Stripe Location ID associated with the cart's fulfillment partner.

Body parameter

{
  "cart": 123
}

Parameters

Example responses

200 Response

{
  "stripe_publishable_api_key": "pk_test_abc123",
  "stripe_location_id": "tml_123"
}

Responses

Card Storage

Create a setup intent

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/setup_intent/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/setup_intent/ HTTP/1.1

Content-Type: application/json
Accept: application/json

const inputBody = '{
  "user": "123",
  "colletion_method": "terminal"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/setup_intent/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/setup_intent/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/setup_intent/', headers = headers)

print(r.json())

 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/setup_intent/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/setup_intent/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/setup_intent/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/setup_intent/

Trigger a request to Stripe to create a setup intent for a user.

Body parameter

{
  "user": "123",
  "colletion_method": "terminal"
}

Parameters

Example responses

200 Response

{
  "stripe_setup_intent_id": "seti_abc213",
  "stripe_publishable_api_key": "pk_test_abc123",
  "client_secret": "seti_abc123_secret_456def"
}

Responses

Create a bankcard from a Stripe payment method

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/store_payment_method/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/store_payment_method/ HTTP/1.1

Content-Type: application/json
Accept: application/json

const inputBody = '{
  "name": "Jane Doe",
  "partner": 72341,
  "payment_method": "pm_1L2PfRI1kLQM3y1JNVjc7KLL",
  "postal_code": 33213,
  "user": 234510
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/store_payment_method/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/store_payment_method/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/store_payment_method/', headers = headers)

print(r.json())

 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/store_payment_method/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/store_payment_method/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/store_payment_method/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/store_payment_method/

Receive a Stripe payment method and create a bankcard based on that information

Body parameter

{
  "name": "Jane Doe",
  "partner": 72341,
  "payment_method": "pm_1L2PfRI1kLQM3y1JNVjc7KLL",
  "postal_code": 33213,
  "user": 234510
}

Parameters

Example responses

200 Response

{
  "payment_method": "pm_1L2PfRI1kLQM3y1JNVjc7KLL",
  "bankcard": 993
}

Responses

Payment Processing

Create a payment intent

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/payment_intent/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/payment_intent/ HTTP/1.1

Content-Type: application/json
Accept: application/json

const inputBody = '{
  "cart": "123",
  "amount": "56.78",
  "account_balance_payment_amount": "12.34",
  "payment_type": "card"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/payment_intent/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/payment_intent/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/payment_intent/', headers = headers)

print(r.json())

 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/payment_intent/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/payment_intent/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/payment_intent/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/payment_intent/

Trigger a request to Stripe to create a payment intent for a cart & amount.

Body parameter

{
  "cart": "123",
  "amount": "56.78",
  "account_balance_payment_amount": "12.34",
  "payment_type": "card"
}

Parameters

Example responses

200 Response

{
  "stripe_payment_intent_id": "pi_abc213",
  "stripe_publishable_api_key": "pk_test_abc123",
  "client_secret": "pi_abc123_secret_456def"
}

Responses

Get the status of a cart

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/payment_status/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/payment_status/ HTTP/1.1

Content-Type: application/json
Accept: application/json

const inputBody = '{
  "cart": "123"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/payment_status/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/payment_status/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/payment_status/', headers = headers)

print(r.json())

 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/payment_status/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/payment_status/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/payment_status/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/payment_status/

Use this endpoint to poll the status of a cart.

Body parameter

{
  "cart": "123"
}

Parameters

Example responses

200 Response

{
  "status": "Open",
  "order": "123",
  "error": "Cool T-Shirt is out of stock :("
}

Responses

Terminal

Create a connection token

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/connection_token/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/connection_token/ HTTP/1.1

Content-Type: application/json
Accept: application/json

const inputBody = '{
  "cart": 123
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/connection_token/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/connection_token/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/connection_token/', headers = headers)

print(r.json())

 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/connection_token/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/connection_token/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/connection_token/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/connection_token/

Create a token to connect to a terminal reader.

Body parameter

{
  "cart": 123
}

Parameters

Example responses

200 Response

{
  "stripe_connection_token": "pst_test_123abc_456def"
}

Responses

Deregister a terminal reader

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/deregister_terminal/ \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/deregister_terminal/ HTTP/1.1

Content-Type: application/json

const inputBody = '{
  "terminal_id": "tmr_123"
}';
const headers = {
  'Content-Type':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/deregister_terminal/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/deregister_terminal/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/deregister_terminal/', headers = headers)

print(r.json())

 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/deregister_terminal/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/deregister_terminal/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/deregister_terminal/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/deregister_terminal/

Deregister a terminal reader.

Body parameter

{
  "terminal_id": "tmr_123"
}

Parameters

Responses

Register a terminal reader

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/register_terminal/ \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/register_terminal/ HTTP/1.1

Content-Type: application/json

const inputBody = '{
  "location": "123",
  "registration_code": "donkey-gecko-inspired",
  "label": "Front Desk"
}';
const headers = {
  'Content-Type':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/register_terminal/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/register_terminal/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/register_terminal/', headers = headers)

print(r.json())

 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/register_terminal/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/register_terminal/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/register_terminal/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/register_terminal/

Register a terminal reader with Stripe.

Body parameter

{
  "location": "123",
  "registration_code": "donkey-gecko-inspired",
  "label": "Front Desk"
}

Parameters

Responses

List terminal readers

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/terminal_readers/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/terminal_readers/ HTTP/1.1

Content-Type: application/json
Accept: application/json

const inputBody = '{
  "location": "123"
}';
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/terminal_readers/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/terminal_readers/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/terminal_readers/', headers = headers)

print(r.json())

 'application/json',
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/terminal_readers/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/terminal_readers/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/terminal_readers/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/terminal_readers/

Query Stripe for the terminal readers registered at a given location.

Body parameter

{
  "location": "123"
}

Parameters

Example responses

200 Response

[
  {
    "terminal_id": "tmr_123",
    "label": "Front Desk"
  }
]

Responses

Update a terminal reader

Code samples

# You can also use wget
curl -X POST /api/stripe/v1/update_terminal/ \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access-token}'

POST /api/stripe/v1/update_terminal/ HTTP/1.1

Content-Type: application/json

const inputBody = '{
  "terminal_id": "tmr_123",
  "label": "Front Desk"
}';
const headers = {
  'Content-Type':'application/json',
  'Authorization':'Bearer {access-token}'
};

fetch('/api/stripe/v1/update_terminal/',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.post '/api/stripe/v1/update_terminal/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('/api/stripe/v1/update_terminal/', headers = headers)

print(r.json())

 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('POST','/api/stripe/v1/update_terminal/', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

 // ...

URL obj = new URL("/api/stripe/v1/update_terminal/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/api/stripe/v1/update_terminal/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /api/stripe/v1/update_terminal/

Update the label on a terminal reader registered with Stripe.

Body parameter

{
  "terminal_id": "tmr_123",
  "label": "Front Desk"
}

Parameters

Responses

Schemas

ConfigurationRequest

{
  "cart": 123
}

Properties

ConfigurationResponse

{
  "stripe_publishable_api_key": "pk_test_abc123",
  "stripe_location_id": "tml_123"
}

Properties

ConnectionTokenRequest

{
  "cart": 123
}

Properties

ConnectionTokenResponse

{
  "stripe_connection_token": "pst_test_123abc_456def"
}

Properties

DeregisterTerminalRequest

{
  "terminal_id": "tmr_123"
}

Properties

PaymentIntentRequest

{
  "cart": "123",
  "amount": "56.78",
  "account_balance_payment_amount": "12.34",
  "payment_type": "card"
}

Properties

Enumerated Values

PaymentIntentResponse

{
  "stripe_payment_intent_id": "pi_abc213",
  "stripe_publishable_api_key": "pk_test_abc123",
  "client_secret": "pi_abc123_secret_456def"
}

Properties

PaymentStatusRequest

{
  "cart": "123"
}

Properties

PaymentStatusResponse

{
  "status": "Open",
  "order": "123",
  "error": "Cool T-Shirt is out of stock :("
}

Properties

RegisterTerminalRequest

{
  "location": "123",
  "registration_code": "donkey-gecko-inspired",
  "label": "Front Desk"
}

Properties

SetupIntentRequest

{
  "user": "123",
  "colletion_method": "terminal"
}

Properties

Enumerated Values

SetupIntentResponse

{
  "stripe_setup_intent_id": "seti_abc213",
  "stripe_publishable_api_key": "pk_test_abc123",
  "client_secret": "seti_abc123_secret_456def"
}

Properties

StorePaymentMethodRequest

{
  "name": "Jane Doe",
  "partner": 72341,
  "payment_method": "pm_1L2PfRI1kLQM3y1JNVjc7KLL",
  "postal_code": 33213,
  "user": 234510
}

Properties

StorePaymentMethodResponse

{
  "payment_method": "pm_1L2PfRI1kLQM3y1JNVjc7KLL",
  "bankcard": 993
}

Properties

TerminalListRequest

{
  "location": "123"
}

Properties

TerminalListResponse

[
  {
    "terminal_id": "tmr_123",
    "label": "Front Desk"
  }
]

Properties

UpdateTerminalRequest

{
  "terminal_id": "tmr_123",
  "label": "Front Desk"
}

Properties