Rinne API Documentation

Create a new transaction for a specific merchant

curl --request POST \
  --url https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "provider": "CELCOIN",
  "request_id": "request-123",
  "amount": 10050,
  "capture_method": "ECOMMERCE",
  "payment_method": "PIX",
  "currency": "BRL",
  "installments": 1,
  "pix_data": {
    "pix_key_id": "pix_key_123",
    "description": "Payment for order #123",
    "expiration_in_seconds": 3600,
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "interest": {
      "percentage": 1,
      "modality": "PERCENTAGE_PER_MONTH"
    },
    "fine": {
      "percentage": 2,
      "modality": "PERCENTAGE"
    },
    "discount": {
      "modality": "PERCENTAGE_UNTIL_DATE",
      "discount_dates_config": [
        {
          "until_date": "2025-12-15",
          "percentage": 10
        },
        {
          "until_date": "2025-12-20",
          "percentage": 5
        }
      ]
    }
  },
  "bolepix_data": {
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "discount": {
      "amount": 5000,
      "modality": "FIXED",
      "until_date": "2025-12-25"
    },
    "fine_percentage": 2,
    "monthly_interest_percentage": 1
  },
  "card_data": {
    "cryptogram": "ev:encrypted:...",
    "expiry_month": "12",
    "expiry_year": "2025",
    "authentication_type": "3DS",
    "wallet_type": "APPLE_PAY",
    "display_name": "Visa •••• 1111"
  },
  "three_d_secure_session_id": "550e8400-e29b-41d4-a716-446655440000",
  "require_3ds": true,
  "refuse_on_challenge": false,
  "consumer": {
    "full_name": "João Silva",
    "email": "[email protected]",
    "pix_key": "[email protected]",
    "document_type": "CPF",
    "document_number": "81146431023",
    "phone": "+5511999999999",
    "birth_date": "15-08-1990"
  },
  "metadata": {
    "order_id": "order-123",
    "customer_id": "cust-456"
  },
  "split_rules": [
    {
      "company_id": "company-1",
      "amount": 5000,
      "charge_processing_cost": true
    },
    {
      "company_id": "company-2",
      "amount": 5050,
      "charge_processing_cost": false
    }
  ],
  "soft_descriptor": "MYSTORE",
  "serial_number": "12345678",
  "nsu": "000123",
  "fee_policy_id": "123e4567-e89b-12d3-a456-426614174000"
}
'

import requests

url = "https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions"

payload = {
    "provider": "CELCOIN",
    "request_id": "request-123",
    "amount": 10050,
    "capture_method": "ECOMMERCE",
    "payment_method": "PIX",
    "currency": "BRL",
    "installments": 1,
    "pix_data": {
        "pix_key_id": "pix_key_123",
        "description": "Payment for order #123",
        "expiration_in_seconds": 3600,
        "due_date": "2025-12-31",
        "expiration_in_days_after_due_date": 30,
        "interest": {
            "percentage": 1,
            "modality": "PERCENTAGE_PER_MONTH"
        },
        "fine": {
            "percentage": 2,
            "modality": "PERCENTAGE"
        },
        "discount": {
            "modality": "PERCENTAGE_UNTIL_DATE",
            "discount_dates_config": [
                {
                    "until_date": "2025-12-15",
                    "percentage": 10
                },
                {
                    "until_date": "2025-12-20",
                    "percentage": 5
                }
            ]
        }
    },
    "bolepix_data": {
        "due_date": "2025-12-31",
        "expiration_in_days_after_due_date": 30,
        "discount": {
            "amount": 5000,
            "modality": "FIXED",
            "until_date": "2025-12-25"
        },
        "fine_percentage": 2,
        "monthly_interest_percentage": 1
    },
    "card_data": {
        "cryptogram": "ev:encrypted:...",
        "expiry_month": "12",
        "expiry_year": "2025",
        "authentication_type": "3DS",
        "wallet_type": "APPLE_PAY",
        "display_name": "Visa •••• 1111"
    },
    "three_d_secure_session_id": "550e8400-e29b-41d4-a716-446655440000",
    "require_3ds": True,
    "refuse_on_challenge": False,
    "consumer": {
        "full_name": "João Silva",
        "email": "[email protected]",
        "pix_key": "[email protected]",
        "document_type": "CPF",
        "document_number": "81146431023",
        "phone": "+5511999999999",
        "birth_date": "15-08-1990"
    },
    "metadata": {
        "order_id": "order-123",
        "customer_id": "cust-456"
    },
    "split_rules": [
        {
            "company_id": "company-1",
            "amount": 5000,
            "charge_processing_cost": True
        },
        {
            "company_id": "company-2",
            "amount": 5050,
            "charge_processing_cost": False
        }
    ],
    "soft_descriptor": "MYSTORE",
    "serial_number": "12345678",
    "nsu": "000123",
    "fee_policy_id": "123e4567-e89b-12d3-a456-426614174000"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: 'CELCOIN',
    request_id: 'request-123',
    amount: 10050,
    capture_method: 'ECOMMERCE',
    payment_method: 'PIX',
    currency: 'BRL',
    installments: 1,
    pix_data: {
      pix_key_id: 'pix_key_123',
      description: 'Payment for order #123',
      expiration_in_seconds: 3600,
      due_date: '2025-12-31',
      expiration_in_days_after_due_date: 30,
      interest: {percentage: 1, modality: 'PERCENTAGE_PER_MONTH'},
      fine: {percentage: 2, modality: 'PERCENTAGE'},
      discount: {
        modality: 'PERCENTAGE_UNTIL_DATE',
        discount_dates_config: [
          {until_date: '2025-12-15', percentage: 10},
          {until_date: '2025-12-20', percentage: 5}
        ]
      }
    },
    bolepix_data: {
      due_date: '2025-12-31',
      expiration_in_days_after_due_date: 30,
      discount: {amount: 5000, modality: 'FIXED', until_date: '2025-12-25'},
      fine_percentage: 2,
      monthly_interest_percentage: 1
    },
    card_data: {
      cryptogram: 'ev:encrypted:...',
      expiry_month: '12',
      expiry_year: '2025',
      authentication_type: '3DS',
      wallet_type: 'APPLE_PAY',
      display_name: 'Visa •••• 1111'
    },
    three_d_secure_session_id: '550e8400-e29b-41d4-a716-446655440000',
    require_3ds: true,
    refuse_on_challenge: false,
    consumer: {
      full_name: 'João Silva',
      email: '[email protected]',
      pix_key: '[email protected]',
      document_type: 'CPF',
      document_number: '81146431023',
      phone: '+5511999999999',
      birth_date: '15-08-1990'
    },
    metadata: {order_id: 'order-123', customer_id: 'cust-456'},
    split_rules: [
      {company_id: 'company-1', amount: 5000, charge_processing_cost: true},
      {company_id: 'company-2', amount: 5050, charge_processing_cost: false}
    ],
    soft_descriptor: 'MYSTORE',
    serial_number: '12345678',
    nsu: '000123',
    fee_policy_id: '123e4567-e89b-12d3-a456-426614174000'
  })
};

fetch('https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => 'CELCOIN',
    'request_id' => 'request-123',
    'amount' => 10050,
    'capture_method' => 'ECOMMERCE',
    'payment_method' => 'PIX',
    'currency' => 'BRL',
    'installments' => 1,
    'pix_data' => [
        'pix_key_id' => 'pix_key_123',
        'description' => 'Payment for order #123',
        'expiration_in_seconds' => 3600,
        'due_date' => '2025-12-31',
        'expiration_in_days_after_due_date' => 30,
        'interest' => [
                'percentage' => 1,
                'modality' => 'PERCENTAGE_PER_MONTH'
        ],
        'fine' => [
                'percentage' => 2,
                'modality' => 'PERCENTAGE'
        ],
        'discount' => [
                'modality' => 'PERCENTAGE_UNTIL_DATE',
                'discount_dates_config' => [
                                [
                                                                'until_date' => '2025-12-15',
                                                                'percentage' => 10
                                ],
                                [
                                                                'until_date' => '2025-12-20',
                                                                'percentage' => 5
                                ]
                ]
        ]
    ],
    'bolepix_data' => [
        'due_date' => '2025-12-31',
        'expiration_in_days_after_due_date' => 30,
        'discount' => [
                'amount' => 5000,
                'modality' => 'FIXED',
                'until_date' => '2025-12-25'
        ],
        'fine_percentage' => 2,
        'monthly_interest_percentage' => 1
    ],
    'card_data' => [
        'cryptogram' => 'ev:encrypted:...',
        'expiry_month' => '12',
        'expiry_year' => '2025',
        'authentication_type' => '3DS',
        'wallet_type' => 'APPLE_PAY',
        'display_name' => 'Visa •••• 1111'
    ],
    'three_d_secure_session_id' => '550e8400-e29b-41d4-a716-446655440000',
    'require_3ds' => true,
    'refuse_on_challenge' => false,
    'consumer' => [
        'full_name' => 'João Silva',
        'email' => '[email protected]',
        'pix_key' => '[email protected]',
        'document_type' => 'CPF',
        'document_number' => '81146431023',
        'phone' => '+5511999999999',
        'birth_date' => '15-08-1990'
    ],
    'metadata' => [
        'order_id' => 'order-123',
        'customer_id' => 'cust-456'
    ],
    'split_rules' => [
        [
                'company_id' => 'company-1',
                'amount' => 5000,
                'charge_processing_cost' => true
        ],
        [
                'company_id' => 'company-2',
                'amount' => 5050,
                'charge_processing_cost' => false
        ]
    ],
    'soft_descriptor' => 'MYSTORE',
    'serial_number' => '12345678',
    'nsu' => '000123',
    'fee_policy_id' => '123e4567-e89b-12d3-a456-426614174000'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions"

	payload := strings.NewReader("{\n  \"provider\": \"CELCOIN\",\n  \"request_id\": \"request-123\",\n  \"amount\": 10050,\n  \"capture_method\": \"ECOMMERCE\",\n  \"payment_method\": \"PIX\",\n  \"currency\": \"BRL\",\n  \"installments\": 1,\n  \"pix_data\": {\n    \"pix_key_id\": \"pix_key_123\",\n    \"description\": \"Payment for order #123\",\n    \"expiration_in_seconds\": 3600,\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"interest\": {\n      \"percentage\": 1,\n      \"modality\": \"PERCENTAGE_PER_MONTH\"\n    },\n    \"fine\": {\n      \"percentage\": 2,\n      \"modality\": \"PERCENTAGE\"\n    },\n    \"discount\": {\n      \"modality\": \"PERCENTAGE_UNTIL_DATE\",\n      \"discount_dates_config\": [\n        {\n          \"until_date\": \"2025-12-15\",\n          \"percentage\": 10\n        },\n        {\n          \"until_date\": \"2025-12-20\",\n          \"percentage\": 5\n        }\n      ]\n    }\n  },\n  \"bolepix_data\": {\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"discount\": {\n      \"amount\": 5000,\n      \"modality\": \"FIXED\",\n      \"until_date\": \"2025-12-25\"\n    },\n    \"fine_percentage\": 2,\n    \"monthly_interest_percentage\": 1\n  },\n  \"card_data\": {\n    \"cryptogram\": \"ev:encrypted:...\",\n    \"expiry_month\": \"12\",\n    \"expiry_year\": \"2025\",\n    \"authentication_type\": \"3DS\",\n    \"wallet_type\": \"APPLE_PAY\",\n    \"display_name\": \"Visa •••• 1111\"\n  },\n  \"three_d_secure_session_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"require_3ds\": true,\n  \"refuse_on_challenge\": false,\n  \"consumer\": {\n    \"full_name\": \"João Silva\",\n    \"email\": \"[email protected]\",\n    \"pix_key\": \"[email protected]\",\n    \"document_type\": \"CPF\",\n    \"document_number\": \"81146431023\",\n    \"phone\": \"+5511999999999\",\n    \"birth_date\": \"15-08-1990\"\n  },\n  \"metadata\": {\n    \"order_id\": \"order-123\",\n    \"customer_id\": \"cust-456\"\n  },\n  \"split_rules\": [\n    {\n      \"company_id\": \"company-1\",\n      \"amount\": 5000,\n      \"charge_processing_cost\": true\n    },\n    {\n      \"company_id\": \"company-2\",\n      \"amount\": 5050,\n      \"charge_processing_cost\": false\n    }\n  ],\n  \"soft_descriptor\": \"MYSTORE\",\n  \"serial_number\": \"12345678\",\n  \"nsu\": \"000123\",\n  \"fee_policy_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"CELCOIN\",\n  \"request_id\": \"request-123\",\n  \"amount\": 10050,\n  \"capture_method\": \"ECOMMERCE\",\n  \"payment_method\": \"PIX\",\n  \"currency\": \"BRL\",\n  \"installments\": 1,\n  \"pix_data\": {\n    \"pix_key_id\": \"pix_key_123\",\n    \"description\": \"Payment for order #123\",\n    \"expiration_in_seconds\": 3600,\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"interest\": {\n      \"percentage\": 1,\n      \"modality\": \"PERCENTAGE_PER_MONTH\"\n    },\n    \"fine\": {\n      \"percentage\": 2,\n      \"modality\": \"PERCENTAGE\"\n    },\n    \"discount\": {\n      \"modality\": \"PERCENTAGE_UNTIL_DATE\",\n      \"discount_dates_config\": [\n        {\n          \"until_date\": \"2025-12-15\",\n          \"percentage\": 10\n        },\n        {\n          \"until_date\": \"2025-12-20\",\n          \"percentage\": 5\n        }\n      ]\n    }\n  },\n  \"bolepix_data\": {\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"discount\": {\n      \"amount\": 5000,\n      \"modality\": \"FIXED\",\n      \"until_date\": \"2025-12-25\"\n    },\n    \"fine_percentage\": 2,\n    \"monthly_interest_percentage\": 1\n  },\n  \"card_data\": {\n    \"cryptogram\": \"ev:encrypted:...\",\n    \"expiry_month\": \"12\",\n    \"expiry_year\": \"2025\",\n    \"authentication_type\": \"3DS\",\n    \"wallet_type\": \"APPLE_PAY\",\n    \"display_name\": \"Visa •••• 1111\"\n  },\n  \"three_d_secure_session_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"require_3ds\": true,\n  \"refuse_on_challenge\": false,\n  \"consumer\": {\n    \"full_name\": \"João Silva\",\n    \"email\": \"[email protected]\",\n    \"pix_key\": \"[email protected]\",\n    \"document_type\": \"CPF\",\n    \"document_number\": \"81146431023\",\n    \"phone\": \"+5511999999999\",\n    \"birth_date\": \"15-08-1990\"\n  },\n  \"metadata\": {\n    \"order_id\": \"order-123\",\n    \"customer_id\": \"cust-456\"\n  },\n  \"split_rules\": [\n    {\n      \"company_id\": \"company-1\",\n      \"amount\": 5000,\n      \"charge_processing_cost\": true\n    },\n    {\n      \"company_id\": \"company-2\",\n      \"amount\": 5050,\n      \"charge_processing_cost\": false\n    }\n  ],\n  \"soft_descriptor\": \"MYSTORE\",\n  \"serial_number\": \"12345678\",\n  \"nsu\": \"000123\",\n  \"fee_policy_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"CELCOIN\",\n  \"request_id\": \"request-123\",\n  \"amount\": 10050,\n  \"capture_method\": \"ECOMMERCE\",\n  \"payment_method\": \"PIX\",\n  \"currency\": \"BRL\",\n  \"installments\": 1,\n  \"pix_data\": {\n    \"pix_key_id\": \"pix_key_123\",\n    \"description\": \"Payment for order #123\",\n    \"expiration_in_seconds\": 3600,\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"interest\": {\n      \"percentage\": 1,\n      \"modality\": \"PERCENTAGE_PER_MONTH\"\n    },\n    \"fine\": {\n      \"percentage\": 2,\n      \"modality\": \"PERCENTAGE\"\n    },\n    \"discount\": {\n      \"modality\": \"PERCENTAGE_UNTIL_DATE\",\n      \"discount_dates_config\": [\n        {\n          \"until_date\": \"2025-12-15\",\n          \"percentage\": 10\n        },\n        {\n          \"until_date\": \"2025-12-20\",\n          \"percentage\": 5\n        }\n      ]\n    }\n  },\n  \"bolepix_data\": {\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"discount\": {\n      \"amount\": 5000,\n      \"modality\": \"FIXED\",\n      \"until_date\": \"2025-12-25\"\n    },\n    \"fine_percentage\": 2,\n    \"monthly_interest_percentage\": 1\n  },\n  \"card_data\": {\n    \"cryptogram\": \"ev:encrypted:...\",\n    \"expiry_month\": \"12\",\n    \"expiry_year\": \"2025\",\n    \"authentication_type\": \"3DS\",\n    \"wallet_type\": \"APPLE_PAY\",\n    \"display_name\": \"Visa •••• 1111\"\n  },\n  \"three_d_secure_session_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"require_3ds\": true,\n  \"refuse_on_challenge\": false,\n  \"consumer\": {\n    \"full_name\": \"João Silva\",\n    \"email\": \"[email protected]\",\n    \"pix_key\": \"[email protected]\",\n    \"document_type\": \"CPF\",\n    \"document_number\": \"81146431023\",\n    \"phone\": \"+5511999999999\",\n    \"birth_date\": \"15-08-1990\"\n  },\n  \"metadata\": {\n    \"order_id\": \"order-123\",\n    \"customer_id\": \"cust-456\"\n  },\n  \"split_rules\": [\n    {\n      \"company_id\": \"company-1\",\n      \"amount\": 5000,\n      \"charge_processing_cost\": true\n    },\n    {\n      \"company_id\": \"company-2\",\n      \"amount\": 5050,\n      \"charge_processing_cost\": false\n    }\n  ],\n  \"soft_descriptor\": \"MYSTORE\",\n  \"serial_number\": \"12345678\",\n  \"nsu\": \"000123\",\n  \"fee_policy_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "tx_123456789",
  "provider": "CELCOIN",
  "affiliation_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
  "request_id": "request-123",
  "mcc": "5411",
  "amount": 10050,
  "currency": "BRL",
  "pricing": {
    "fee": {
      "percentage": 2.5,
      "flat": 50,
      "minimum_price": 100
    },
    "cost": {
      "percentage": 2.5,
      "flat": 50,
      "minimum_price": 100
    }
  },
  "status": "APPROVED",
  "capture_method": "EMV",
  "installments": 1,
  "payment_method": "PIX",
  "automatic_anticipation": false,
  "company_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
  "created_at": "2023-12-01T10:00:00.000Z",
  "fee_policy_id": "fee_policy_123",
  "cost_policy_id": "cost_policy_123",
  "approved_amount": 10050,
  "refunded_amount": 0,
  "three_d_secure_session_id": "550e8400-e29b-41d4-a716-446655440000",
  "acquirer_response_code": "00",
  "pix_data": {
    "pix_key_id": "pix_key_123",
    "description": "Payment for order #123",
    "qr_code": "00020126580014br.gov.bcb.pix0136a3dbd0c2-9f79-4f86-8caa-47779b3f2793520400005303986540510.005802BR5913Test Company6008São Paulo62070503***6304E2CA",
    "expires_at": "2023-12-02T10:00:00.000Z",
    "identification": "order_123",
    "expiration_in_seconds": 86400,
    "end_to_end_id": "E12345678202312101234567890123456",
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "interest": {
      "modality": "PERCENTAGE_PER_MONTH",
      "amount": 1000,
      "percentage": 10.5
    },
    "fine": {
      "modality": "PERCENTAGE",
      "amount": 2000,
      "percentage": 2.5
    },
    "discount": {
      "modality": "PERCENTAGE_UNTIL_DATE",
      "amount": 2,
      "percentage": 50,
      "discount_dates_config": [
        {
          "until_date": "2025-12-15",
          "percentage": 10
        },
        {
          "until_date": "2025-12-20",
          "percentage": 5
        }
      ]
    },
    "abatement": {
      "modality": "FIXED",
      "amount": 5000,
      "percentage": 5
    }
  },
  "bolepix_data": {
    "pix_key_id": "pix_key_123",
    "external_request_id": "ext-req-123",
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "boleto_transaction_id": "boleto-123",
    "bank_issuer": "Banco do Brasil",
    "bank_code": "001",
    "bank_branch": "1234",
    "bank_account_number": "12345-6",
    "bar_code": "00190000090299993600000000000000185830000010000",
    "bank_line": "00190.00009 02999.936001 00000.000001 8 58300000010000",
    "bank_assignor": "Company Name",
    "pix_transaction_id": "pix-123",
    "pix_identification": "txid123456789",
    "pix_emv": "00020126580014br.gov.bcb.pix...",
    "paid_via": "PIX",
    "paid_amount": 50000,
    "paid_at": "2025-12-20T10:00:00.000Z",
    "discount": {
      "amount": 5000,
      "percentage": 10,
      "modality": "FIXED",
      "until_date": "2025-12-25"
    },
    "fine_percentage": 2,
    "monthly_interest_percentage": 1
  },
  "card_data": {
    "last_digits": "1111",
    "expiry_month": "12",
    "expiry_year": "2028",
    "brand": "VISA",
    "device_id": "device-123",
    "cardholder_name": "John Doe",
    "country": "BR",
    "wallet_type": "APPLE_PAY",
    "display_name": "Visa •••• 1111",
    "authentication_type": "3DS"
  },
  "soft_descriptor": "MYSTORE",
  "serial_number": "12345678",
  "nsu": "000123",
  "metadata": "<unknown>",
  "latest_refund_at": "2023-12-01T10:00:00.000Z",
  "status_reason": "PROVIDER",
  "approved_at": "2023-12-01T10:00:00.000Z",
  "company_full_name": "Test Company",
  "company_name": "Test Company",
  "organization_id": "tx_organization_123456",
  "consumer": {
    "document_type": "CPF",
    "full_name": "João Silva",
    "email": "[email protected]",
    "pix_key": "[email protected]",
    "document_number": "81146431023",
    "phone": "+5511999999999",
    "birth_date": "15-08-1990",
    "address": {
      "street": "Rua das Flores",
      "neighborhood": "Centro",
      "zipcode": "12345678",
      "country": "076",
      "state": "SP",
      "city": "São Paulo",
      "street_number": "123",
      "complement": "Apt 101"
    }
  },
  "updated_at": "2023-12-01T10:00:00.000Z"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation error",
    "status": 400,
    "details": {
      "issues": [
        {
          "field": "email",
          "type": "REQUIRED",
          "message": "Field 'email' is required",
          "value": "invalid_value",
          "constraints": {
            "min": 18,
            "max": 120
          }
        }
      ]
    },
    "path": "/companies",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Authentication required to access this resource",
    "status": 401,
    "details": {
      "reason": "Invalid API key"
    },
    "path": "/companies/me",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "AUTHORIZATION_ERROR",
    "message": "You need 'admin' permissions to access this resource",
    "status": 403,
    "path": "/companies",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Company with ID '123' not found",
    "status": 404,
    "path": "/companies/me",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred",
    "status": 500,
    "path": "/companies",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

POST

merchants

{merchantId}

transactions

Create a new transaction for a specific merchant

curl --request POST \
  --url https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "provider": "CELCOIN",
  "request_id": "request-123",
  "amount": 10050,
  "capture_method": "ECOMMERCE",
  "payment_method": "PIX",
  "currency": "BRL",
  "installments": 1,
  "pix_data": {
    "pix_key_id": "pix_key_123",
    "description": "Payment for order #123",
    "expiration_in_seconds": 3600,
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "interest": {
      "percentage": 1,
      "modality": "PERCENTAGE_PER_MONTH"
    },
    "fine": {
      "percentage": 2,
      "modality": "PERCENTAGE"
    },
    "discount": {
      "modality": "PERCENTAGE_UNTIL_DATE",
      "discount_dates_config": [
        {
          "until_date": "2025-12-15",
          "percentage": 10
        },
        {
          "until_date": "2025-12-20",
          "percentage": 5
        }
      ]
    }
  },
  "bolepix_data": {
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "discount": {
      "amount": 5000,
      "modality": "FIXED",
      "until_date": "2025-12-25"
    },
    "fine_percentage": 2,
    "monthly_interest_percentage": 1
  },
  "card_data": {
    "cryptogram": "ev:encrypted:...",
    "expiry_month": "12",
    "expiry_year": "2025",
    "authentication_type": "3DS",
    "wallet_type": "APPLE_PAY",
    "display_name": "Visa •••• 1111"
  },
  "three_d_secure_session_id": "550e8400-e29b-41d4-a716-446655440000",
  "require_3ds": true,
  "refuse_on_challenge": false,
  "consumer": {
    "full_name": "João Silva",
    "email": "[email protected]",
    "pix_key": "[email protected]",
    "document_type": "CPF",
    "document_number": "81146431023",
    "phone": "+5511999999999",
    "birth_date": "15-08-1990"
  },
  "metadata": {
    "order_id": "order-123",
    "customer_id": "cust-456"
  },
  "split_rules": [
    {
      "company_id": "company-1",
      "amount": 5000,
      "charge_processing_cost": true
    },
    {
      "company_id": "company-2",
      "amount": 5050,
      "charge_processing_cost": false
    }
  ],
  "soft_descriptor": "MYSTORE",
  "serial_number": "12345678",
  "nsu": "000123",
  "fee_policy_id": "123e4567-e89b-12d3-a456-426614174000"
}
'

import requests

url = "https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions"

payload = {
    "provider": "CELCOIN",
    "request_id": "request-123",
    "amount": 10050,
    "capture_method": "ECOMMERCE",
    "payment_method": "PIX",
    "currency": "BRL",
    "installments": 1,
    "pix_data": {
        "pix_key_id": "pix_key_123",
        "description": "Payment for order #123",
        "expiration_in_seconds": 3600,
        "due_date": "2025-12-31",
        "expiration_in_days_after_due_date": 30,
        "interest": {
            "percentage": 1,
            "modality": "PERCENTAGE_PER_MONTH"
        },
        "fine": {
            "percentage": 2,
            "modality": "PERCENTAGE"
        },
        "discount": {
            "modality": "PERCENTAGE_UNTIL_DATE",
            "discount_dates_config": [
                {
                    "until_date": "2025-12-15",
                    "percentage": 10
                },
                {
                    "until_date": "2025-12-20",
                    "percentage": 5
                }
            ]
        }
    },
    "bolepix_data": {
        "due_date": "2025-12-31",
        "expiration_in_days_after_due_date": 30,
        "discount": {
            "amount": 5000,
            "modality": "FIXED",
            "until_date": "2025-12-25"
        },
        "fine_percentage": 2,
        "monthly_interest_percentage": 1
    },
    "card_data": {
        "cryptogram": "ev:encrypted:...",
        "expiry_month": "12",
        "expiry_year": "2025",
        "authentication_type": "3DS",
        "wallet_type": "APPLE_PAY",
        "display_name": "Visa •••• 1111"
    },
    "three_d_secure_session_id": "550e8400-e29b-41d4-a716-446655440000",
    "require_3ds": True,
    "refuse_on_challenge": False,
    "consumer": {
        "full_name": "João Silva",
        "email": "[email protected]",
        "pix_key": "[email protected]",
        "document_type": "CPF",
        "document_number": "81146431023",
        "phone": "+5511999999999",
        "birth_date": "15-08-1990"
    },
    "metadata": {
        "order_id": "order-123",
        "customer_id": "cust-456"
    },
    "split_rules": [
        {
            "company_id": "company-1",
            "amount": 5000,
            "charge_processing_cost": True
        },
        {
            "company_id": "company-2",
            "amount": 5050,
            "charge_processing_cost": False
        }
    ],
    "soft_descriptor": "MYSTORE",
    "serial_number": "12345678",
    "nsu": "000123",
    "fee_policy_id": "123e4567-e89b-12d3-a456-426614174000"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: 'CELCOIN',
    request_id: 'request-123',
    amount: 10050,
    capture_method: 'ECOMMERCE',
    payment_method: 'PIX',
    currency: 'BRL',
    installments: 1,
    pix_data: {
      pix_key_id: 'pix_key_123',
      description: 'Payment for order #123',
      expiration_in_seconds: 3600,
      due_date: '2025-12-31',
      expiration_in_days_after_due_date: 30,
      interest: {percentage: 1, modality: 'PERCENTAGE_PER_MONTH'},
      fine: {percentage: 2, modality: 'PERCENTAGE'},
      discount: {
        modality: 'PERCENTAGE_UNTIL_DATE',
        discount_dates_config: [
          {until_date: '2025-12-15', percentage: 10},
          {until_date: '2025-12-20', percentage: 5}
        ]
      }
    },
    bolepix_data: {
      due_date: '2025-12-31',
      expiration_in_days_after_due_date: 30,
      discount: {amount: 5000, modality: 'FIXED', until_date: '2025-12-25'},
      fine_percentage: 2,
      monthly_interest_percentage: 1
    },
    card_data: {
      cryptogram: 'ev:encrypted:...',
      expiry_month: '12',
      expiry_year: '2025',
      authentication_type: '3DS',
      wallet_type: 'APPLE_PAY',
      display_name: 'Visa •••• 1111'
    },
    three_d_secure_session_id: '550e8400-e29b-41d4-a716-446655440000',
    require_3ds: true,
    refuse_on_challenge: false,
    consumer: {
      full_name: 'João Silva',
      email: '[email protected]',
      pix_key: '[email protected]',
      document_type: 'CPF',
      document_number: '81146431023',
      phone: '+5511999999999',
      birth_date: '15-08-1990'
    },
    metadata: {order_id: 'order-123', customer_id: 'cust-456'},
    split_rules: [
      {company_id: 'company-1', amount: 5000, charge_processing_cost: true},
      {company_id: 'company-2', amount: 5050, charge_processing_cost: false}
    ],
    soft_descriptor: 'MYSTORE',
    serial_number: '12345678',
    nsu: '000123',
    fee_policy_id: '123e4567-e89b-12d3-a456-426614174000'
  })
};

fetch('https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => 'CELCOIN',
    'request_id' => 'request-123',
    'amount' => 10050,
    'capture_method' => 'ECOMMERCE',
    'payment_method' => 'PIX',
    'currency' => 'BRL',
    'installments' => 1,
    'pix_data' => [
        'pix_key_id' => 'pix_key_123',
        'description' => 'Payment for order #123',
        'expiration_in_seconds' => 3600,
        'due_date' => '2025-12-31',
        'expiration_in_days_after_due_date' => 30,
        'interest' => [
                'percentage' => 1,
                'modality' => 'PERCENTAGE_PER_MONTH'
        ],
        'fine' => [
                'percentage' => 2,
                'modality' => 'PERCENTAGE'
        ],
        'discount' => [
                'modality' => 'PERCENTAGE_UNTIL_DATE',
                'discount_dates_config' => [
                                [
                                                                'until_date' => '2025-12-15',
                                                                'percentage' => 10
                                ],
                                [
                                                                'until_date' => '2025-12-20',
                                                                'percentage' => 5
                                ]
                ]
        ]
    ],
    'bolepix_data' => [
        'due_date' => '2025-12-31',
        'expiration_in_days_after_due_date' => 30,
        'discount' => [
                'amount' => 5000,
                'modality' => 'FIXED',
                'until_date' => '2025-12-25'
        ],
        'fine_percentage' => 2,
        'monthly_interest_percentage' => 1
    ],
    'card_data' => [
        'cryptogram' => 'ev:encrypted:...',
        'expiry_month' => '12',
        'expiry_year' => '2025',
        'authentication_type' => '3DS',
        'wallet_type' => 'APPLE_PAY',
        'display_name' => 'Visa •••• 1111'
    ],
    'three_d_secure_session_id' => '550e8400-e29b-41d4-a716-446655440000',
    'require_3ds' => true,
    'refuse_on_challenge' => false,
    'consumer' => [
        'full_name' => 'João Silva',
        'email' => '[email protected]',
        'pix_key' => '[email protected]',
        'document_type' => 'CPF',
        'document_number' => '81146431023',
        'phone' => '+5511999999999',
        'birth_date' => '15-08-1990'
    ],
    'metadata' => [
        'order_id' => 'order-123',
        'customer_id' => 'cust-456'
    ],
    'split_rules' => [
        [
                'company_id' => 'company-1',
                'amount' => 5000,
                'charge_processing_cost' => true
        ],
        [
                'company_id' => 'company-2',
                'amount' => 5050,
                'charge_processing_cost' => false
        ]
    ],
    'soft_descriptor' => 'MYSTORE',
    'serial_number' => '12345678',
    'nsu' => '000123',
    'fee_policy_id' => '123e4567-e89b-12d3-a456-426614174000'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions"

	payload := strings.NewReader("{\n  \"provider\": \"CELCOIN\",\n  \"request_id\": \"request-123\",\n  \"amount\": 10050,\n  \"capture_method\": \"ECOMMERCE\",\n  \"payment_method\": \"PIX\",\n  \"currency\": \"BRL\",\n  \"installments\": 1,\n  \"pix_data\": {\n    \"pix_key_id\": \"pix_key_123\",\n    \"description\": \"Payment for order #123\",\n    \"expiration_in_seconds\": 3600,\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"interest\": {\n      \"percentage\": 1,\n      \"modality\": \"PERCENTAGE_PER_MONTH\"\n    },\n    \"fine\": {\n      \"percentage\": 2,\n      \"modality\": \"PERCENTAGE\"\n    },\n    \"discount\": {\n      \"modality\": \"PERCENTAGE_UNTIL_DATE\",\n      \"discount_dates_config\": [\n        {\n          \"until_date\": \"2025-12-15\",\n          \"percentage\": 10\n        },\n        {\n          \"until_date\": \"2025-12-20\",\n          \"percentage\": 5\n        }\n      ]\n    }\n  },\n  \"bolepix_data\": {\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"discount\": {\n      \"amount\": 5000,\n      \"modality\": \"FIXED\",\n      \"until_date\": \"2025-12-25\"\n    },\n    \"fine_percentage\": 2,\n    \"monthly_interest_percentage\": 1\n  },\n  \"card_data\": {\n    \"cryptogram\": \"ev:encrypted:...\",\n    \"expiry_month\": \"12\",\n    \"expiry_year\": \"2025\",\n    \"authentication_type\": \"3DS\",\n    \"wallet_type\": \"APPLE_PAY\",\n    \"display_name\": \"Visa •••• 1111\"\n  },\n  \"three_d_secure_session_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"require_3ds\": true,\n  \"refuse_on_challenge\": false,\n  \"consumer\": {\n    \"full_name\": \"João Silva\",\n    \"email\": \"[email protected]\",\n    \"pix_key\": \"[email protected]\",\n    \"document_type\": \"CPF\",\n    \"document_number\": \"81146431023\",\n    \"phone\": \"+5511999999999\",\n    \"birth_date\": \"15-08-1990\"\n  },\n  \"metadata\": {\n    \"order_id\": \"order-123\",\n    \"customer_id\": \"cust-456\"\n  },\n  \"split_rules\": [\n    {\n      \"company_id\": \"company-1\",\n      \"amount\": 5000,\n      \"charge_processing_cost\": true\n    },\n    {\n      \"company_id\": \"company-2\",\n      \"amount\": 5050,\n      \"charge_processing_cost\": false\n    }\n  ],\n  \"soft_descriptor\": \"MYSTORE\",\n  \"serial_number\": \"12345678\",\n  \"nsu\": \"000123\",\n  \"fee_policy_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"CELCOIN\",\n  \"request_id\": \"request-123\",\n  \"amount\": 10050,\n  \"capture_method\": \"ECOMMERCE\",\n  \"payment_method\": \"PIX\",\n  \"currency\": \"BRL\",\n  \"installments\": 1,\n  \"pix_data\": {\n    \"pix_key_id\": \"pix_key_123\",\n    \"description\": \"Payment for order #123\",\n    \"expiration_in_seconds\": 3600,\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"interest\": {\n      \"percentage\": 1,\n      \"modality\": \"PERCENTAGE_PER_MONTH\"\n    },\n    \"fine\": {\n      \"percentage\": 2,\n      \"modality\": \"PERCENTAGE\"\n    },\n    \"discount\": {\n      \"modality\": \"PERCENTAGE_UNTIL_DATE\",\n      \"discount_dates_config\": [\n        {\n          \"until_date\": \"2025-12-15\",\n          \"percentage\": 10\n        },\n        {\n          \"until_date\": \"2025-12-20\",\n          \"percentage\": 5\n        }\n      ]\n    }\n  },\n  \"bolepix_data\": {\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"discount\": {\n      \"amount\": 5000,\n      \"modality\": \"FIXED\",\n      \"until_date\": \"2025-12-25\"\n    },\n    \"fine_percentage\": 2,\n    \"monthly_interest_percentage\": 1\n  },\n  \"card_data\": {\n    \"cryptogram\": \"ev:encrypted:...\",\n    \"expiry_month\": \"12\",\n    \"expiry_year\": \"2025\",\n    \"authentication_type\": \"3DS\",\n    \"wallet_type\": \"APPLE_PAY\",\n    \"display_name\": \"Visa •••• 1111\"\n  },\n  \"three_d_secure_session_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"require_3ds\": true,\n  \"refuse_on_challenge\": false,\n  \"consumer\": {\n    \"full_name\": \"João Silva\",\n    \"email\": \"[email protected]\",\n    \"pix_key\": \"[email protected]\",\n    \"document_type\": \"CPF\",\n    \"document_number\": \"81146431023\",\n    \"phone\": \"+5511999999999\",\n    \"birth_date\": \"15-08-1990\"\n  },\n  \"metadata\": {\n    \"order_id\": \"order-123\",\n    \"customer_id\": \"cust-456\"\n  },\n  \"split_rules\": [\n    {\n      \"company_id\": \"company-1\",\n      \"amount\": 5000,\n      \"charge_processing_cost\": true\n    },\n    {\n      \"company_id\": \"company-2\",\n      \"amount\": 5050,\n      \"charge_processing_cost\": false\n    }\n  ],\n  \"soft_descriptor\": \"MYSTORE\",\n  \"serial_number\": \"12345678\",\n  \"nsu\": \"000123\",\n  \"fee_policy_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.rinne.com.br/core/v1/merchants/{merchantId}/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"CELCOIN\",\n  \"request_id\": \"request-123\",\n  \"amount\": 10050,\n  \"capture_method\": \"ECOMMERCE\",\n  \"payment_method\": \"PIX\",\n  \"currency\": \"BRL\",\n  \"installments\": 1,\n  \"pix_data\": {\n    \"pix_key_id\": \"pix_key_123\",\n    \"description\": \"Payment for order #123\",\n    \"expiration_in_seconds\": 3600,\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"interest\": {\n      \"percentage\": 1,\n      \"modality\": \"PERCENTAGE_PER_MONTH\"\n    },\n    \"fine\": {\n      \"percentage\": 2,\n      \"modality\": \"PERCENTAGE\"\n    },\n    \"discount\": {\n      \"modality\": \"PERCENTAGE_UNTIL_DATE\",\n      \"discount_dates_config\": [\n        {\n          \"until_date\": \"2025-12-15\",\n          \"percentage\": 10\n        },\n        {\n          \"until_date\": \"2025-12-20\",\n          \"percentage\": 5\n        }\n      ]\n    }\n  },\n  \"bolepix_data\": {\n    \"due_date\": \"2025-12-31\",\n    \"expiration_in_days_after_due_date\": 30,\n    \"discount\": {\n      \"amount\": 5000,\n      \"modality\": \"FIXED\",\n      \"until_date\": \"2025-12-25\"\n    },\n    \"fine_percentage\": 2,\n    \"monthly_interest_percentage\": 1\n  },\n  \"card_data\": {\n    \"cryptogram\": \"ev:encrypted:...\",\n    \"expiry_month\": \"12\",\n    \"expiry_year\": \"2025\",\n    \"authentication_type\": \"3DS\",\n    \"wallet_type\": \"APPLE_PAY\",\n    \"display_name\": \"Visa •••• 1111\"\n  },\n  \"three_d_secure_session_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"require_3ds\": true,\n  \"refuse_on_challenge\": false,\n  \"consumer\": {\n    \"full_name\": \"João Silva\",\n    \"email\": \"[email protected]\",\n    \"pix_key\": \"[email protected]\",\n    \"document_type\": \"CPF\",\n    \"document_number\": \"81146431023\",\n    \"phone\": \"+5511999999999\",\n    \"birth_date\": \"15-08-1990\"\n  },\n  \"metadata\": {\n    \"order_id\": \"order-123\",\n    \"customer_id\": \"cust-456\"\n  },\n  \"split_rules\": [\n    {\n      \"company_id\": \"company-1\",\n      \"amount\": 5000,\n      \"charge_processing_cost\": true\n    },\n    {\n      \"company_id\": \"company-2\",\n      \"amount\": 5050,\n      \"charge_processing_cost\": false\n    }\n  ],\n  \"soft_descriptor\": \"MYSTORE\",\n  \"serial_number\": \"12345678\",\n  \"nsu\": \"000123\",\n  \"fee_policy_id\": \"123e4567-e89b-12d3-a456-426614174000\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "tx_123456789",
  "provider": "CELCOIN",
  "affiliation_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
  "request_id": "request-123",
  "mcc": "5411",
  "amount": 10050,
  "currency": "BRL",
  "pricing": {
    "fee": {
      "percentage": 2.5,
      "flat": 50,
      "minimum_price": 100
    },
    "cost": {
      "percentage": 2.5,
      "flat": 50,
      "minimum_price": 100
    }
  },
  "status": "APPROVED",
  "capture_method": "EMV",
  "installments": 1,
  "payment_method": "PIX",
  "automatic_anticipation": false,
  "company_id": "a3dbd0c2-9f79-4f86-8caa-47779b3f2793",
  "created_at": "2023-12-01T10:00:00.000Z",
  "fee_policy_id": "fee_policy_123",
  "cost_policy_id": "cost_policy_123",
  "approved_amount": 10050,
  "refunded_amount": 0,
  "three_d_secure_session_id": "550e8400-e29b-41d4-a716-446655440000",
  "acquirer_response_code": "00",
  "pix_data": {
    "pix_key_id": "pix_key_123",
    "description": "Payment for order #123",
    "qr_code": "00020126580014br.gov.bcb.pix0136a3dbd0c2-9f79-4f86-8caa-47779b3f2793520400005303986540510.005802BR5913Test Company6008São Paulo62070503***6304E2CA",
    "expires_at": "2023-12-02T10:00:00.000Z",
    "identification": "order_123",
    "expiration_in_seconds": 86400,
    "end_to_end_id": "E12345678202312101234567890123456",
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "interest": {
      "modality": "PERCENTAGE_PER_MONTH",
      "amount": 1000,
      "percentage": 10.5
    },
    "fine": {
      "modality": "PERCENTAGE",
      "amount": 2000,
      "percentage": 2.5
    },
    "discount": {
      "modality": "PERCENTAGE_UNTIL_DATE",
      "amount": 2,
      "percentage": 50,
      "discount_dates_config": [
        {
          "until_date": "2025-12-15",
          "percentage": 10
        },
        {
          "until_date": "2025-12-20",
          "percentage": 5
        }
      ]
    },
    "abatement": {
      "modality": "FIXED",
      "amount": 5000,
      "percentage": 5
    }
  },
  "bolepix_data": {
    "pix_key_id": "pix_key_123",
    "external_request_id": "ext-req-123",
    "due_date": "2025-12-31",
    "expiration_in_days_after_due_date": 30,
    "boleto_transaction_id": "boleto-123",
    "bank_issuer": "Banco do Brasil",
    "bank_code": "001",
    "bank_branch": "1234",
    "bank_account_number": "12345-6",
    "bar_code": "00190000090299993600000000000000185830000010000",
    "bank_line": "00190.00009 02999.936001 00000.000001 8 58300000010000",
    "bank_assignor": "Company Name",
    "pix_transaction_id": "pix-123",
    "pix_identification": "txid123456789",
    "pix_emv": "00020126580014br.gov.bcb.pix...",
    "paid_via": "PIX",
    "paid_amount": 50000,
    "paid_at": "2025-12-20T10:00:00.000Z",
    "discount": {
      "amount": 5000,
      "percentage": 10,
      "modality": "FIXED",
      "until_date": "2025-12-25"
    },
    "fine_percentage": 2,
    "monthly_interest_percentage": 1
  },
  "card_data": {
    "last_digits": "1111",
    "expiry_month": "12",
    "expiry_year": "2028",
    "brand": "VISA",
    "device_id": "device-123",
    "cardholder_name": "John Doe",
    "country": "BR",
    "wallet_type": "APPLE_PAY",
    "display_name": "Visa •••• 1111",
    "authentication_type": "3DS"
  },
  "soft_descriptor": "MYSTORE",
  "serial_number": "12345678",
  "nsu": "000123",
  "metadata": "<unknown>",
  "latest_refund_at": "2023-12-01T10:00:00.000Z",
  "status_reason": "PROVIDER",
  "approved_at": "2023-12-01T10:00:00.000Z",
  "company_full_name": "Test Company",
  "company_name": "Test Company",
  "organization_id": "tx_organization_123456",
  "consumer": {
    "document_type": "CPF",
    "full_name": "João Silva",
    "email": "[email protected]",
    "pix_key": "[email protected]",
    "document_number": "81146431023",
    "phone": "+5511999999999",
    "birth_date": "15-08-1990",
    "address": {
      "street": "Rua das Flores",
      "neighborhood": "Centro",
      "zipcode": "12345678",
      "country": "076",
      "state": "SP",
      "city": "São Paulo",
      "street_number": "123",
      "complement": "Apt 101"
    }
  },
  "updated_at": "2023-12-01T10:00:00.000Z"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation error",
    "status": 400,
    "details": {
      "issues": [
        {
          "field": "email",
          "type": "REQUIRED",
          "message": "Field 'email' is required",
          "value": "invalid_value",
          "constraints": {
            "min": 18,
            "max": 120
          }
        }
      ]
    },
    "path": "/companies",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Authentication required to access this resource",
    "status": 401,
    "details": {
      "reason": "Invalid API key"
    },
    "path": "/companies/me",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "AUTHORIZATION_ERROR",
    "message": "You need 'admin' permissions to access this resource",
    "status": 403,
    "path": "/companies",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Company with ID '123' not found",
    "status": 404,
    "path": "/companies/me",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred",
    "status": 500,
    "path": "/companies",
    "timestamp": "2023-12-01T10:00:00.000Z",
    "requestId": "req_123456789"
  }
}

Authorizations

x-api-key

string

header

required

Company API key for authentication

Path Parameters

merchantId

string

required

The merchant ID

Body

application/json

Schema for creating a new transaction.

provider

enum<string>

required

Payment provider identifier

Available options:

CELCOIN

Example:

"CELCOIN"

request_id

string

required

Unique request ID for this transaction (used for idempotency)

Minimum string length: 1

Example:

"request-123"

amount

integer

required

Transaction amount in cents (e.g., 10050 = R$ 100,50)

Required range: 1 <= x <= 1500000000

Example:

10050

capture_method

enum<string>

required

Transaction capture method:

EMV: Chip card
MAGSTRIPE: Magnetic stripe
ECOMMERCE: Online transaction
CONTACTLESS_ICC: Contactless payment

Available options:

EMV,

MAGSTRIPE,

ECOMMERCE,

CONTACTLESS_ICC

Example:

"ECOMMERCE"

payment_method

enum<string>

required

Payment method:

CREDIT_CARD: Credit card payment
DEBIT_CARD: Debit card payment
PIX: Instant payment
BOLEPIX: Hybrid Boleto + PIX payment

Available options:

CREDIT_CARD,

DEBIT_CARD,

PIX,

BOLEPIX

Example:

"PIX"

currency

enum<string>

default:BRL

Transaction currency (defaults to BRL)

Available options:

BRL

Example:

"BRL"

installments

integer

default:1

Number of installments (1-18). Defaults to 1 if not sent. Must be 1 when payment_method is PIX or BOLEPIX.

Required range: 1 <= x <= 18

Example:

1

pix_data

object

PIX-specific data. Required when payment_method is PIX. When due_date is provided: consumer is required (full_name, document_number, document_type) and use expiration_in_days_after_due_date (do not send expiration_in_seconds). When due_date is NOT provided: use expiration_in_seconds (do not send expiration_in_days_after_due_date).

Show child attributes

Example:

{
  "pix_key_id": "pix_key_123",
  "description": "Payment for order #123",
  "expiration_in_seconds": 3600,
  "due_date": "2025-12-31",
  "expiration_in_days_after_due_date": 30,
  "interest": {
    "percentage": 1,
    "modality": "PERCENTAGE_PER_MONTH"
  },
  "fine": { "percentage": 2, "modality": "PERCENTAGE" },
  "discount": {
    "modality": "PERCENTAGE_UNTIL_DATE",
    "discount_dates_config": [
      {
        "until_date": "2025-12-15",
        "percentage": 10
      },
      {
        "until_date": "2025-12-20",
        "percentage": 5
      }
    ]
  }
}

bolepix_data

object

BOLEPIX-specific data. Required when payment_method is BOLEPIX. When payment_method is BOLEPIX, consumer is required with full_name, document_type, document_number, and full address including address.street_number.

Show child attributes

Example:

{
  "due_date": "2025-12-31",
  "expiration_in_days_after_due_date": 30,
  "discount": {
    "amount": 5000,
    "modality": "FIXED",
    "until_date": "2025-12-25"
  },
  "fine_percentage": 2,
  "monthly_interest_percentage": 1
}

card_data

object

Card payment data. Required for CREDIT_CARD and DEBIT_CARD payment methods.

Option 1
Option 2
Option 3

Show child attributes

Example:

{
  "cryptogram": "ev:encrypted:...",
  "expiry_month": "12",
  "expiry_year": "2025",
  "authentication_type": "3DS",
  "wallet_type": "APPLE_PAY",
  "display_name": "Visa •••• 1111"
}

three_d_secure_session_id

string<uuid>

ID of an authenticated 3DS session to use for this transaction (session-first flow). When provided, the cryptogram and ECI from the session are injected into the card data. The session must be authenticated (auth_status=AUTHENTICATED), not expired, not already consumed, and match the transaction's company, amount, and currency.

Example:

"550e8400-e29b-41d4-a716-446655440000"

require_3ds

boolean

Card transactions only. When true, the transaction is created directly in AWAITING_3DS and is not sent to the provider until /authenticate is called with an authenticated 3DS session.

Example:

true

refuse_on_challenge

boolean

Card transactions only. When true, challenge-triggered paths are refused (REFUSED) instead of transitioning to AWAITING_3DS. Cannot be true together with require_3ds.

Example:

false

consumer

object

Optional consumer/customer information. Required with full_name, document_number, and document_type when pix_data.due_date is provided. When payment_method is BOLEPIX, consumer is required and must include full_name, document_type, document_number, and full address including address.street_number.

Show child attributes

Example:

{
  "full_name": "João Silva",
  "email": "[email protected]",
  "pix_key": "[email protected]",
  "document_type": "CPF",
  "document_number": "81146431023",
  "phone": "+5511999999999",
  "birth_date": "15-08-1990"
}

metadata

object

Optional additional metadata (key-value pairs)

Example:

{
  "order_id": "order-123",
  "customer_id": "cust-456"
}

split_rules

object[]

Optional split rules for transaction revenue sharing.

Important rules:

Cannot mix amount and percentage in same transaction
If using amounts: sum must equal transaction amount
If using percentages: sum must equal 100%

Show child attributes

Example:

[
  {
    "company_id": "company-1",
    "amount": 5000,
    "charge_processing_cost": true
  },
  {
    "company_id": "company-2",
    "amount": 5050,
    "charge_processing_cost": false
  }
]

soft_descriptor

string

Optional text shown on cardholder statement (max 13 chars)

Maximum string length: 13

Example:

"MYSTORE"

serial_number

string

Optional terminal serial number

Example:

"12345678"

nsu

string

Optional Network Sequential Number

Example:

"000123"

fee_policy_id

string

Optional fee policy ID to use for this transaction. If provided, this takes priority over the company's default fee policy. The fee policy must belong to the same organization as the company.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

Transaction created successfully

Transaction data returned by the API

string

required

Transaction unique identifier

Example:

"tx_123456789"

provider

enum<string>

required

Payment provider

Available options:

CELCOIN,

RINNE,

CAPPTA

Example:

"CELCOIN"

affiliation_id

string

required

Affiliation ID for this transaction

Example:

"a3dbd0c2-9f79-4f86-8caa-47779b3f2793"

request_id

string

required

Unique request ID for this transaction used for idempotency

Example:

"request-123"

mcc

string

required

Merchant Category Code

Example:

"5411"

amount

integer

required

Transaction amount in cents

Example:

10050

currency

enum<string>

required

Transaction currency

Available options:

BRL

Example:

"BRL"

pricing

object

required

Transaction pricing information

Show child attributes

status

enum<string>

required

Transaction status

Available options:

PROCESSING,

AUTHORIZED,

APPROVED,

REFUNDED,

PARTIALLY_REFUNDED,

PENDING_REFUND,

CHARGEDBACK,

WAITING_PAYMENT,

AWAITING_3DS,

REFUSED,

FAILED,

EXPIRED,

PENDING_CANCELLATION,

CANCELLED

Example:

"APPROVED"

capture_method

enum<string>

required

Transaction capture method

Available options:

EMV,

MAGSTRIPE,

ECOMMERCE,

CONTACTLESS_ICC

Example:

"EMV"

installments

integer | null

required

Number of installments

Example:

1

payment_method

enum<string>

required

Payment method

Available options:

CREDIT_CARD,

DEBIT_CARD,

PIX,

BOLEPIX

Example:

"PIX"

automatic_anticipation

boolean

required

Whether this transaction was automatically anticipated at creation time. Set to true when the affiliation's anticipation_type is AUTOMATIC; false otherwise.

Example:

false

company_id

string

required

Company ID that owns this transaction

Example:

"a3dbd0c2-9f79-4f86-8caa-47779b3f2793"

created_at

string<date-time>

required

Transaction creation timestamp

Example:

"2023-12-01T10:00:00.000Z"

fee_policy_id

string | null

Fee policy ID applied to this transaction

Example:

"fee_policy_123"

cost_policy_id

string | null

Cost policy ID applied to this transaction

Example:

"cost_policy_123"

approved_amount

integer | null

Approved amount in cents

Example:

10050

refunded_amount

integer | null

Total amount refunded in cents (sum of completed refunds)

Example:

0

three_d_secure_session_id

string<uuid> | null

ID of the 3DS session linked to this transaction, if any. Set when the transaction was created with a 3DS session (session-first flow) or authenticated via the /authenticate endpoint (transaction-first flow).

Example:

"550e8400-e29b-41d4-a716-446655440000"

acquirer_response_code

string | null

Acquirer response code

Example:

"00"

pix_data

object | null

PIX-specific data (present if payment_method is PIX)

Show child attributes

bolepix_data

object | null

Bolepix-specific data (present if payment_method is BOLEPIX)

Show child attributes

card_data

object | null

Card-specific data (present if payment_method is CREDIT_CARD or DEBIT_CARD)

Show child attributes

soft_descriptor

string | null

Soft descriptor shown on cardholder statement

Example:

"MYSTORE"

serial_number

string | null

Terminal serial number

Example:

"12345678"

nsu

string | null

Network Sequential Number

Example:

"000123"

metadata

object | null

Additional metadata

latest_refund_at

string<date-time> | null

Latest refund timestamp (for the most recent completed refund)

Example:

"2023-12-01T10:00:00.000Z"

status_reason

enum<string> | null

Status reason details. REVERSED indicates a failed card transaction whose charge was later found at the acquirer and reversed by reconciliation.

Available options:

PROVIDER,

ACQUIRER,

ANTIFRAUD,

INTERNAL_ERROR,

NO_ACQUIRER,

ACQUIRER_TIMEOUT,

CHALLENGE_NOT_ALLOWED,

REVERSED

Example:

"PROVIDER"

approved_at

string | null

Transaction approval timestamp

Example:

"2023-12-01T10:00:00.000Z"

company_full_name

string

Company full name

Example:

"Test Company"

company_name

string | null

Company name

Example:

"Test Company"

organization_id

string | null

Organization transaction ID (for refunds/chargebacks)

Example:

"tx_organization_123456"

consumer

object | null

Consumer information

Show child attributes

updated_at

string<date-time> | null

Transaction last update timestamp

Example:

"2023-12-01T10:00:00.000Z"

Get merchant overview Create a 3D Secure session linked to a merchant

⌘I

Introduction

Merchants

Pricing

Webhooks

Organization Management

User Management

System

Create a new transaction for a specific merchant

Authorizations

Path Parameters

Body

Response