Carouseller
Home
  • 🚀Getting started
    • Payment glossary
  • Cashier integration
    • Key obtaining
    • Cashier opening
      • iFrame
      • Native version
    • Cashier opening 2.0
      • iFrame
    • Payment processing
    • Webhooks
      • Successful transaction conditions
      • Notification parameters
    • Report request
    • Tracking user's activity in the cashier
    • User reset conditions
    • Signature
  • Payment API
    • API 1.0
      • Key obtaining
      • Deposit
      • Payout
      • Transaction status
    • API 2.0
      • Payment Page Integration
      • Transaction statuses
    • 3DS handler
  • Transaction types
  • Payment methods
  • Test card numbers
Powered by GitBook
On this page
  • Request address
  • Headers
  • Request Parameters
  • Request Example
  • Response Example
  • Response Example: 404
  • Response Example: 403
  • Transaction statuses
  1. Payment API
  2. API 1.0

Transaction status

Request address

https://{domain}/v1/payments/status/

Headers

{“Content-Type: “application/json”}

Request Parameters

Name
Required
Type
Description
Example

order_id

Yes

String

Carouseller order id

1231254123123

external_id

Yes

String

Client side order id

1231254123123

site_login

Yes

String

Client side user id

12345678

site_id

Yes

Int

Client id provided by support with documentation

24

signature

Yes

String

d9f5713990de5c6e32169dba1f0102f540018975

Request must have either 'order_id' or 'external_id'

Request Example

{
    "site_id": 24,
    "site_login": "443122443122",
    "order_id": "116922645998424527087015816996",
    "signature": "signature_example"
}

Response Example

{
    "success": true,
    "order_id": "116922645998424527087015816996",
    "payment_group_id": 1027,
    "external_id": "1412423",
    "status_id": 4,
    "amount": 1000,
    "currency": "USD",
    "real_amount": 1000,
    "real_currency": "USD",
    "site_login": "443122443122",
    "customer_ip": "185.56.232.170",
    "customer_purse": "354911...9321",
    "processor_code": null
}

Response Example: 404

{
    "success": false,
    "errors": {
        "order_id": "Transaction not found"
    }
}

Response Example: 403

}
    "success": false,
    "errors": {
        "signature": ["Signature is invalid"]
    }
}

Transaction statuses

ID
Operation status
Description

1

initiated

Transaction is created in the system

2

external processing

Transaction currently waiting for notification from external system

3

awaiting confirmation

Transaction is waiting for Merchant response - confirm or void

4

success

Successful transaction

5

void

Declined authorization

6

processor decline

Processor declined to conduct transaction

7

fraudstop decline

System Fraud Stop declined operation

8

mpi decline

Based on the results of MPI work it was decided not to conduct transaction

10

system failure

An error occurred during payment processing

11

unsupported protocol

Protocol does not support the operation

12

protocol configuration error

Protocol configuration error

13

transaction is expired

Transaction is expired

14

transaction rejected by user

Transaction rejected by user

15

internal error

Failure to process a transaction within the system

19

external error

External processor error

20

blank

Informative transaction. Status shouldn’t affect anything!

21

representment

Transaction/Chargeback documents sent to the payment system for dispute

22

chargeback won

Won chargeback and returned money

23

chargeback lost

Lost chargeback and lost money

24

partial success

PreviousPayoutNextAPI 2.0

Last updated 7 months ago

Request signature,

see Request signature generating rules
Page cover image