Obter Informações da Instância

Este endpoint permite recuperar informações detalhadas sobre uma transação de Pay-In específica. O campo merchantOrderId é obrigatório e corresponde ao identificador único gerado pelo comerciante no momento da criação da instância de pagamento.

Endpoint

GEThttps://api.tylt.money/p2pRampsMerchant/getInstanceDetails?merchantOrderId={merchantOrderId}

Example Request

GEThttps://api.tylt.money/p2pRampsMerchant/getInstanceDetails?merchantOrderId=dOf6cc25-e9f9-11ef-830e-02d8461243e9

Request Headers

Name
Type
Example
Description

X-TLP-APIKEY

string

93ee3c5e133697251b5362bcf9cc8532476785t8768075616f58d88

Sua Chave de API Tylt, utilizada para identificar sua conta nas requisições da API.

X-TLP-SIGNATURE

string

d0afef3853dfc8489c8b9affa5825171fdd7y7685675e4966a05f66ed2b3eaf9462b3c9c0

Assinatura HMAC SHA-256 gerada utilizando a Chave Secreta da API para proteger a requisição.

Ao utilizar a API, certifique-se de incluir sua Chave de API e gerar a assinatura da carga da requisição utilizando sua Chave Secreta da API. As tabelas fornecidas acima contêm valores de exemplo apenas para fins ilustrativos. Consulte os trechos de código para obter instruções detalhadas sobre como assinar corretamente a requisição e gerar a assinatura.

Code Snippet

import json
import hashlib
import hmac
import requests

# Replace with your API Key and Secret
api_key = 'your-api-key'
api_secret = 'your-secret-key'

# Function to create HMAC SHA-256 signature
def create_signature(secret, data):
    return hmac.new(secret.encode(), data.encode(), hashlib.sha256).hexdigest()

# Function to send a GET request
def send_get_request(url, params):
    raw = '&'.join([f"{key}={value}" for key, value in params.items()])
    body_string = json.dumps(params, separators=(',', ':'), ensure_ascii=False)
    signature = create_signature(api_secret, body_string)

    headers = {
        'X-TLP-APIKEY': api_key,
        'X-TLP-SIGNATURE': signature
    }

    response = requests.get(f"{url}?{raw}", headers=headers)
    return response.json()

# Request parameters for GET request
get_params = {
    'instanceId': 'dOf6cc25-e9f9-11ef-830e-02d8461243e9'
}

# Send the GET request
get_response = send_get_request("https://api.tylt.money/p2pRampsMerchant/getInstanceDetails", get_params)
print(get_response)

Response

Para compreender melhor o ciclo de vida do processo de pagamento e utilizar de forma eficaz os dados fornecidos pela API Get Instance Information, consulte a explicação detalhada do ciclo de eventos : LINK

{
    "msg": "",
    "data": {
        "trade": {
            "isBuyTrade":1,
            "event": {
                "id": null,
                "deadline": null,
                "description": null
            },
            "createdAt": null,
            "updatedAt": null,
            "fiatCurrency": {
                "name": null,
                "symbol": null
            },
            "priceDetails": {
                "price": null,
                "amount": null,
                "paymentAmount": null
            },
            "paymentMethod": {
                "details": null
            },
            "cryptoCurrency": {
                "name": null,
                "symbol": null
            }
        },
        "transaction": {
            "amount": null,
            "status": null,
            "isFinal": null,
            "orderId": null,
            "createdAt": null,
            "isCredited": null,
            "updatedAt": null,
            "merchantOrderId": null
        },
        "user": {}
    }
}

Last updated