Latam Payments API Docs
  • Welcome!
  • Quick Start
  • Reference
    • API Reference
      • Authentication
      • Merchant Onboarding and Payment Flow
        • Collectors
        • Store
        • Point of Sales
      • QR
      • Reconciliation Files
      • Callbacks
Powered by GitBook
On this page
  • Create a new Store for a Collector
  • Get an existing Store
  • Get all Stores
  • Update an existing Store
  • Disable a Store
  1. Reference
  2. API Reference
  3. Merchant Onboarding and Payment Flow

Store

Within the Depay system, a Store represents the physical or digital retail outlet operated by a customer (merchant). It is where the customer’s transactions occur using interoperable QR codes and where our payment integration is implemented. Each Store is a unique entity under a customer account, enabling detailed management and analysis of transactions specific to that location. Whether a customer operates a single store or multiple shops across different locations, each is treated as a distinct Store within our platform, facilitating effective cross-border payment management.

Our API includes various endpoints to manage Stores effectively, facilitating operations such as adding new Stores, retrieving information about specific Stores, and updating Store details. This allows customers to tailor their payment processing setup to each Store's needs, ensuring a seamless and efficient payment experience.

Create a new Store for a Collector

POST https://stage.api.payments.depay.us/collectors/{collector_uuid}/stores

This endpoint allows you to create a new Store, within the Depay ecosystem, for a specific Collector.

Query Parameters

Name
Type
Description

collector_uuid

String

collector identifiier

Headers

Name
Type
Description

Authorization*

String

Bearer Token

Request Body

Name
Type
Description

description*

String

A brief description of the store being registered

external_reference*

String

An external identifier provided by the user to uniquely reference the store in their own system.

address*

String

The physical address of the store, used for reference and location purposes.

phone*

String

The contact phone number for the store, useful for communications and inquiries.

manager*

String

The name of the person responsible for managing the store.

Request Body Example
{
    "description": "Retail store specializing in electronics",
    "external_reference": "store_12345",
    "address": "123 Tech Street, Cityville",
    "phone": "123-456-7890",
    "manager": "Jane Doe"
}
{
    "status": 201,
    "message": "Store created",
    "data": {
        "uuid": "16146fd1-aee2-444e-916d-586e7debb9e7",
        "createdAt": "2025-06-06T17:45:29.345Z",
        "updatedAt": "2025-06-06T17:45:29.345Z",
        "description": "123",
        "externalReference": "6203569c-2e16-43a7-aeaa-f244c8b38856",
        "address": "Av. Siempreviva 432",
        "phone": "test8@depay.us",
        "manager": "John Doe",
        "collector": {
            "uuid": "188f08fc-80c6-4d62-b723-06007c974efe",
            "createdAt": "2025-06-06T15:37:16.358Z",
            "updatedAt": "2025-06-06T15:37:16.358Z",
            "externalReference": "c2594bb7-c27a-47b3-8a6b-29f7cf023886",
            "name": "Collector Test",
            "fantasty_name": "Collector Test",
            "description": "Collector de prueba",
            "tax_id": "213123123",
            "image": null,
            "regular_contact_email": "test60@depay.us",
            "regular_contact_phone": "12313123",
            "country_code": "AR",
            "address": "Av. Siempreviva 432",
            "code": "123",
            "company": null,
            "category": null,
            "color": null
        },
        "point_of_sales": []
    }
}
{
    "statusCode": 401,
    "message": "Unauthorized"
}
{
    "statusCode": 404,
    "message": "Error creating the store. Collector not found"
}
{
    "response": {
        "message": "Error description",
    }
}

Get an existing Store

GET https://stage.api.payments.depay.us/stores/{uuid}

This endpoint allows you to retrieve the details of an existing Store using its unique identifier (UUID).

Query Parameters

Name
Type
Description

uuid*

string

Store identifier

Headers

Name
Type
Description

Authentication*

string

Bearer Token

{
    "uuid": "eb3550e7-92ea-4a15-9990-13a95c52600e",
    "createdAt": "2025-06-06T17:56:37.642Z",
    "updatedAt": "2025-06-06T17:56:37.642Z",
    "description": "123",
    "externalReference": "d97c884a-aebc-451f-a375-b6061afcf582",
    "address": "Av. Siempreviva 432",
    "phone": "test1@depay.us",
    "manager": "John Doe",
    "collector": {
        "uuid": "188f08fc-80c6-4d62-b723-06007c974efe",
        "createdAt": "2025-06-06T15:37:16.358Z",
        "updatedAt": "2025-06-06T15:37:16.358Z",
        "externalReference": "c2594bb7-c27a-47b3-8a6b-29f7cf023886",
        "name": "Collector Test",
        "fantasty_name": "Collector Test",
        "description": "Collector de prueba",
        "tax_id": "213123123",
        "image": null,
        "regular_contact_email": "test60@depay.us",
        "regular_contact_phone": "12313123",
        "country_code": "AR",
        "address": "Av. Siempreviva 432",
        "code": "123",
        "company": null,
        "category": null,
        "color": null
    },
    "point_of_sales": []
}

{
    "statusCode": 401,
    "message": "Unauthorized"
}
{
    "statusCode": 404,
    "message": "Store not found"
}

Get all Stores

GET https://stage.api.payments.depay.us/collectors/{collector_uuid}/stores

This endpoint allows you to retrieve a list of all existing Stores in the Depay ecosystem, for a specific Collector.

Query Parameters

Name
Type
Description

collector_uuid

String

customer identifier

Headers

Name
Type
Description

Authorization*

String

Bearer Token

[
    {
        "uuid": "fa036507-ca23-4426-94a4-746ca3bc18cb",
        "createdAt": "2025-06-06T17:50:16.551Z",
        "updatedAt": "2025-06-06T17:50:16.551Z",
        "description": "123",
        "externalReference": "09124d3a-3f46-40a1-9aee-d41f9623dd31",
        "address": "Av. Siempreviva 432",
        "phone": "test8@depay.us",
        "manager": "John Doe"
    },
    {
        "uuid": "eb3550e7-92ea-4a15-9990-13a95c52600e",
        "createdAt": "2025-06-06T17:56:37.642Z",
        "updatedAt": "2025-06-06T17:56:37.642Z",
        "description": "123",
        "externalReference": "d97c884a-aebc-451f-a375-b6061afcf582",
        "address": "Av. Siempreviva 432",
        "phone": "test1@depay.us",
        "manager": "John Doe"
    }
]
{
    "statusCode": 401,
    "message": "Unauthorized"
}
{
    "statusCode": 404,
    "message": "Collector not found"
}

Update an existing Store

PATCH https://stage.api.payments.depay.us/stores/{uuid}

This endpoint allows you to update the details of an existing Store in the Depay ecosystem.

Query Parameters

Name
Type
Description

uuid*

String

Store identifier

Request Body

Name
Type
Description

description*

String

A brief description of the store being registered

external_reference*

String

An external identifier provided by the user to uniquely reference the store in their own system.

address*

String

The physical address of the store, used for reference and location purposes.

phone*

String

The contact phone number for the store, useful for communications and inquiries.

manager*

String

The name of the person responsible for managing the store.

{
    "status": 201,
    "message": "Store updated"
}ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd
{
    "statusCode": 401,
    "message": "Unauthorized"
}
{
    "statusCode": 404,
    "message": "Store not found"
}

Disable a Store

PUT https://stage.api.payments.depay.us/stores/{uuid}/disable

This endpoint allows you to disable an existing Store in the Depay ecosystem.

Query Parameters

Name
Type
Description

uuid*

String

Branch identifier

Headers

Name
Type
Description

Authorization*

String

Bearer Token

PreviousCollectorsNextPoint of Sales

Last updated 6 days ago