Documentation: https://wallet.teamapricot.com/api/v1

Parameters

Recommended Headers

Accept: application/json
Authorization: Bearer <tu_token>
Content-Type: application/json

Body Example (JSON)

{
  "img": "https://example.com/imagen.jpg",
  "invoice_id": "1",
  "amount": "100.00",
  "currency": "USDT",
  "description": "Pago de factura #1",
  "customer_email": "demo@demo.com",
  "status": "prod",
  "product_name": "Nombre del producto"
}

cURL Example

curl -X POST "https://wallet.teamapricot.com/api/v1/pay" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"invoice_id":"1","amount":"100.00","currency":"USDT","customer_email":"demo@demo.com","status":"prod"}'

Response Example (200)

{
  "status": "success",
  "data": {
    "exito": 1,
    "invoice_id": "1",
    "date": "2024-01-01",
    "amount": "100.00",
    "currency": "USDT",
    "payment_url": "https://payment.example/checkout/abc123"
  }
}

Common Errors

• 401 Unauthorized: Invalid or not provided token.
• 404 Not Found: Route not found.
• 400 Bad Request: Invalid parameters.
• 403 API token is inactive: Api token is inactive

Redirection to the Payment Page

Once the response with the payment URL (<code>payment_url</code>) is received, the client must redirect the user to that URL to complete the payment process. Examples of how to perform this redirection in different programming languages are shown below.

Client Examples

$url = https://wallet.teamapricot.com/api/v1/pay;

$payload = [
    "img" => "",
    "api_token" => "123456",
    "invoice_id" => "1",
    "amount" => "100.00",
    "currency" => "USDT",
    "description" => "Pago de factura #1",
    "customer_email" => "demo@demo.com",
    "status" => "prod",
    "product_name" => "test"
];

$headers = [
    'Accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer tu_token_aqui'
];

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    echo 'Error: ' . curl_error($ch);
} else {
    if ($httpCode >= 200 && $httpCode < 300) {
        $data = json_decode($response, true);
        if (!empty($data['data']['payment_url'])) {
            header("Location: " . $data['data']['payment_url']);
            exit;
        } else {
            echo "Respuesta recibida:\n";
            print_r($data);

        }
    } else {
        echo "Error HTTP: $httpCode\n";
        print_r(json_decode($response, true));
    }
}
curl_close($ch);

Workflow

1. The client sends a POST request to the <code>https://wallet.teamapricot.com/api/v1/pay</code> endpoint with the necessary parameters and the authentication token in the headers.
2. The server processes the request and validates the provided data.
3. If the request is valid, the server creates an invoice and generates a unique payment URL.
4. The server responds with a JSON including the payment URL in the <code>payment_url</code> field.
5. The client redirects the user to the payment URL to complete the transaction.
6. The user completes the payment on the provided payment page.
7. The server notifies the client about the payment status via the configured webhook URL.
8. The webhook redirection will contain the following parameters:
   • case: Indicates the case being executed (pay, login, etc)
   • result: Indicates the payment status (1 for success, 0 for failure).
   • invoce_id: The unique invoice identifier provided by the client.
   • redirection example: https://tuwebhook.com?case=pay&result=1&invoce_id=12345

Notes

• Make sure to handle errors and API responses properly in your client application.
• Redirection to the payment URL should only be done if the response is successful and contains the URL.