# Récupérer un transfert L'API de la plateforme Moneroo propose une route qui vous permet de récupérer les informations détaillées d'une transaction de transfert spécifique basée sur son identifiant unique de transaction. \ Ce guide vous expliquera comment récupérer une transaction de reversement en utilisant l'API de Moneroo. ### Requête ```bash GET /v1/payouts/{payoutId} HTTP/1.1 Host: https://api.moneroo.io Authorization: Bearer YOUR_SECRET_KEY Content-Type: application/json Accept: application/json ``` #### Paramètres * Route: `/v1/payouts/{payoutId}` * Méthode: `GET`
ChampTypeRequisDescription
payoutIdStringOuiIdentifiant unique de transaction.sutr
### **Structure d'une réponse** La réponse de cette route de l'API sera au format standard de réponse de l'API Moneroo.\ Vous recevrez une réponse qui ressemble à ceci : ```json { "success": true, "message": "Payout transaction fetched successfully", "data": { // Details of the payout transaction } } ``` **Réponse en cas de réussite** :\ En cas de récupération réussie, la route de l'API retourne un code de statut HTTP **200** et les détails de la transaction de paiement dans le corps de la réponse. **Réponses en cas d'échec** :\ S'il y a un problème avec votre requête, l'API renverra une réponse d'erreur. Le type de réponse d'erreur dépend de la nature du problème. Consultez notre page sur le format des réponses pour plus d'informations. ### Considérations de sécurité Cette route de l'API nécessite un *jeton Bearer* pour l'authentification. Le jeton Bearer doit être inclus dans l'en-tête `Authorization` de la requête. Assurez-vous que le jeton est gardé en sécurité et qu'il n'est ni partagé ni exposé de manière inappropriée. ### Exemple de requête {% tabs %} {% tab title="Curl" %} ```bash curl --location --request GET 'https://api.moneroo.io/v1/payouts/{payoutId}' \ --header 'Authorization: Bearer YOUR_TOKEN' ``` {% endtab %} {% tab title="JavaScript" %} ```javascript const axios = require("axios"); const payoutId = "your_payout_public_id"; const token = "your_token"; axios .get(`https://api.moneroo.io/v1/payouts/${payoutId}`, { headers: { Authorization: `Bearer ${token}`, }, }) .then((response) => { if (response.status === 200) { const data = response.data; // Handle successful response and retrieve the payout transaction details } else { // Handle error response } }) .catch((error) => { // Handle error }); ``` {% endtab %} {% tab title="Python" %} ```python import requests payout_public_id = 'your_payout_public_id' token = 'your_token' headers = { 'Authorization': f'Bearer {token}' } response = requests.get(f'https://api.moneroo.io/v1/payouts/{payout_public_id}', headers=headers) if response.status_code == 200: data = response.json() # Handle successful response and retrieve the payout transaction details else: # Handle error response ``` {% endtab %} {% tab title="Go" %} ```go package main import ( "fmt" "net/http" "io/ioutil" ) func main() { payoutPublicID := "your_payout_public_id" token := "your_token" url := fmt.Sprintf("https://api.moneroo.io/v1/payouts/%s", payoutPublicID) req, err := http.NewRequest("GET", url, nil) if err != nil { // Handle error } req.Header.Set("Authorization", fmt.Sprintf("Bearer %s", token)) client := &http.Client{} resp, err := client.Do(req) if err != nil { // Handle error } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { // Handle error } if resp.StatusCode == 200 { // Handle successful response and retrieve the payout transaction details } else { // Handle error response } } ``` {% endtab %} {% tab title="PHP" %} ```php "https://api.moneroo.io/v1/payouts/{$payoutId}", CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer {$token}" ] ]); $response = curl_exec($curl); $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE); if ($httpCode === 200) { $responseData = json_decode($response, true); // Handle successful response and retrieve the payout transaction details } else { // Handle error response } curl_close($curl) ``` {% endtab %} {% endtabs %} Please replace `'payoutId'` with the actual payout transaction Id and `'your_token'` with your valid authorization token in the code snippets above. ### Exemple de réponse Vous recevrez une réponse qui ressemble à ceci : ```json { "success": true, "message": "Payout transaction fetched successfully", "data": { "id": "abc123", "status": "success", "is_processed": true, "processed_at": "2023-05-21T12:00:00Z", "amount": 100.0, "currency": "USD", "amount_formatted": "$100.00", "description": "Purchase of goods", "return_url": "https://example.com/return", "environment": "production", "initiated_at": "2023-05-21T11:00:00Z", "payout_phone_number": "+1234567890", "app": { "id": "app1", "name": "Example App", "icon_url": "https://example.com/icon.png" }, "customer": { "id": "cust1", "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "phone": "+1234567890", "address": "123 Main St", "city": "Springfield", "state": "IL", "country_code": "US", "country": "United States", "zip_code": "62701", "environment": "production", "created_at": "2023-01-01T00:00:00Z", "updated_at": "2023-05-21T00:00:00Z" }, "method": { "name": "Credit Card", "code": "cc", "icon_url": "https://example.com/cc.png", "environment": "production" }, "gateway": { "name": "Stripe", "account_name": "Acme Corp", "code": "stripe", "icon_url": "https://example.com/stripe.png", "environment": "production" }, "metadata": { "custom_field1": "custom_value1", "custom_field2": "custom_value2" }, "context": { "ip": "192.0.2.0", "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (HTML, like Gecko) Chrome/58.0.3029.110 Safari/537", "country": "US", "local": "en-US" } } } ``` Le champ `data` contiendra les détails de la transaction. La structure et le contenu spécifiques de ce champ dépendent des détails de la transaction.