Returns transactions from Shinkansen

​

Returns a list of transactions based on the provided filters.

Query Parameters

  • transaction_type
    Type: string
    required

    Must be "payin"

  • fin_id
    Type: string

    If present, filter by financial institution ID

  • creditor_account
    Type: string

    If present, filter by creditor account

  • debtor_account
    Type: string

    If present, filter by debtor account

  • creditor_fin_id
    Type: string

    If present, filter by creditor financial institution ID

  • creditor_id
    Type: string

    If present, filter by creditor ID

  • shinkansen_transaction_id
    Type: stringFormat: uuid

    If present, filter by Shinkansen transaction ID

  • transaction_id
    Type: stringFormat: uuid

    If present, filter by transaction ID

  • shinkansen_transaction_status
    Type: string

    If present, filter by transaction status

  • limit
    Type: integer
    min:  
    1

    Maximum number of transactions to return (defaults to 1000)

  • order_by
    Type: string

    Field to order results by

  • before_internal_id
    Type: integer
    min:  
    1

    If present, filter by transactions before this internal ID

  • before_datetime
    Type: stringFormat: date-time

    If present, filter by transactions before this datetime. Example 2024-01-01T00:00:00Z

  • after_datetime
    Type: stringFormat: date-time

    If present, filter by transactions after this datetime. Example 2024-01-01T00:00:00Z

  • delivered
    Type: boolean

    If present, filter by delivery status

  • debtor_account_schema_id
    Type: string

    If present, filter by debtor account financial institution ID. See docs.

  • creditor_account_schema_id
    Type: string

    If present, filter by creditor account financial institution ID. See docs.

Responses

  • application/json
  • 400

    Invalid message (e.g: invalid signature)

  • 403

    Forbidden (e.g: wrong API Key)

Request Example for get/transactions
curl 'https://api.shinkansen.finance/v1/transactions?transaction_type=&limit=1000' \
  --header 'Shinkansen-Api-Key: YOUR_SECRET_TOKEN'

[
  {
    "shinkansen_transaction_status": "pending",
    "transaction": {
      "amount": "500.00000",
      "creditor": {
        "account": "987654321",
        "account_type": "current_account",
        "email": "payments@startech.com",
        "financial_institution": {
          "fin_id": "BANCO_STELLAR_CL",
          "fin_id_schema": "SHINKANSEN"
        },
        "identification": {
          "id": "98765432-1",
          "id_schema": "CLID"
        },
        "name": "StarTech Solutions Ltd"
      },
      "currency": "CLP",
      "debtor": {
        "account": "123456789",
        "account_type": "current_account",
        "email": "finance@cosmicretail.com",
        "financial_institution": {
          "fin_id": "BANCO_STELLAR_CL",
          "fin_id_schema": "SHINKANSEN"
        },
        "identification": {
          "id": "12345678-9",
          "id_schema": "CLID"
        },
        "name": "Cosmic Retail Corp"
      },
      "description": "Service subscription payment",
      "expiration_date": "2024-03-15T15:00:00Z",
      "interactive_payment_failure_redirect_url": "https://startech.com/payments/failure",
      "interactive_payment_success_redirect_url": "https://startech.com/payments/success",
      "internal_id": 456,
      "metadata": null,
      "payin_type": "interactive_payment",
      "shinkansen_delivered_at": null,
      "shinkansen_received_at": "2024-03-01T10:00:00Z",
      "shinkansen_transaction_id": "f7922b99-d31c-46ee-9721-b5756d71bed7",
      "transaction_id": "a2fb8246-861b-47e2-93cd-60f24f526462",
      "transaction_type": "payin",
      "ttl": null
    }
  }
]

List of transactions

Previous
Sends a payin message
Next
Returns the transaction status