Criar cobrança Pix

curl --request POST \
  --url https://api.pagmaster.site/api/v1/public/pix/charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amountCents": 10000,
  "payerName": "Ana Souza",
  "description": "Pedido 123",
  "requestKey": "1c35e888-9ab1-43c1-ac74-66e9be46c450"
}
'

import requests

url = "https://api.pagmaster.site/api/v1/public/pix/charges"

payload = {
    "amountCents": 10000,
    "payerName": "Ana Souza",
    "description": "Pedido 123",
    "requestKey": "1c35e888-9ab1-43c1-ac74-66e9be46c450"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amountCents: 10000,
    payerName: 'Ana Souza',
    description: 'Pedido 123',
    requestKey: '1c35e888-9ab1-43c1-ac74-66e9be46c450'
  })
};

fetch('https://api.pagmaster.site/api/v1/public/pix/charges', 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.pagmaster.site/api/v1/public/pix/charges",
  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([
    'amountCents' => 10000,
    'payerName' => 'Ana Souza',
    'description' => 'Pedido 123',
    'requestKey' => '1c35e888-9ab1-43c1-ac74-66e9be46c450'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.pagmaster.site/api/v1/public/pix/charges"

	payload := strings.NewReader("{\n  \"amountCents\": 10000,\n  \"payerName\": \"Ana Souza\",\n  \"description\": \"Pedido 123\",\n  \"requestKey\": \"1c35e888-9ab1-43c1-ac74-66e9be46c450\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.pagmaster.site/api/v1/public/pix/charges")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amountCents\": 10000,\n  \"payerName\": \"Ana Souza\",\n  \"description\": \"Pedido 123\",\n  \"requestKey\": \"1c35e888-9ab1-43c1-ac74-66e9be46c450\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pagmaster.site/api/v1/public/pix/charges")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amountCents\": 10000,\n  \"payerName\": \"Ana Souza\",\n  \"description\": \"Pedido 123\",\n  \"requestKey\": \"1c35e888-9ab1-43c1-ac74-66e9be46c450\"\n}"

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

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "deposit",
  "amountCents": 123,
  "status": "draft",
  "createdAt": "2023-11-07T05:31:56Z",
  "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "feeCents": 1,
  "updatedAt": "2023-11-07T05:31:56Z",
  "settledAt": "2023-11-07T05:31:56Z",
  "paymentMethod": "pix",
  "expiresAt": "2023-11-07T05:31:56Z",
  "copyPaste": "<string>",
  "qrCodeBase64": "<string>",
  "endToEnd": "<string>",
  "notice": "<string>",
  "providerFeeCents": 1,
  "netAmountCents": 1,
  "debitAmountCents": 1001,
  "expectedNetAmountCents": 2,
  "paidAt": "2023-11-07T05:31:56Z",
  "checkoutUrl": "<string>",
  "releaseAt": "2023-11-07T05:31:56Z",
  "cardSettlementStatus": "held",
  "card": {
    "status": "processing",
    "brand": "visa",
    "last4": "<string>",
    "installments": 1,
    "refusedReason": "<string>",
    "attemptsLeft": 1
  }
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

POST

pix

charges

Criar cobrança Pix

curl --request POST \
  --url https://api.pagmaster.site/api/v1/public/pix/charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amountCents": 10000,
  "payerName": "Ana Souza",
  "description": "Pedido 123",
  "requestKey": "1c35e888-9ab1-43c1-ac74-66e9be46c450"
}
'

import requests

url = "https://api.pagmaster.site/api/v1/public/pix/charges"

payload = {
    "amountCents": 10000,
    "payerName": "Ana Souza",
    "description": "Pedido 123",
    "requestKey": "1c35e888-9ab1-43c1-ac74-66e9be46c450"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amountCents: 10000,
    payerName: 'Ana Souza',
    description: 'Pedido 123',
    requestKey: '1c35e888-9ab1-43c1-ac74-66e9be46c450'
  })
};

fetch('https://api.pagmaster.site/api/v1/public/pix/charges', 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.pagmaster.site/api/v1/public/pix/charges",
  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([
    'amountCents' => 10000,
    'payerName' => 'Ana Souza',
    'description' => 'Pedido 123',
    'requestKey' => '1c35e888-9ab1-43c1-ac74-66e9be46c450'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.pagmaster.site/api/v1/public/pix/charges"

	payload := strings.NewReader("{\n  \"amountCents\": 10000,\n  \"payerName\": \"Ana Souza\",\n  \"description\": \"Pedido 123\",\n  \"requestKey\": \"1c35e888-9ab1-43c1-ac74-66e9be46c450\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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.pagmaster.site/api/v1/public/pix/charges")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amountCents\": 10000,\n  \"payerName\": \"Ana Souza\",\n  \"description\": \"Pedido 123\",\n  \"requestKey\": \"1c35e888-9ab1-43c1-ac74-66e9be46c450\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pagmaster.site/api/v1/public/pix/charges")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amountCents\": 10000,\n  \"payerName\": \"Ana Souza\",\n  \"description\": \"Pedido 123\",\n  \"requestKey\": \"1c35e888-9ab1-43c1-ac74-66e9be46c450\"\n}"

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

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "kind": "deposit",
  "amountCents": 123,
  "status": "draft",
  "createdAt": "2023-11-07T05:31:56Z",
  "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "feeCents": 1,
  "updatedAt": "2023-11-07T05:31:56Z",
  "settledAt": "2023-11-07T05:31:56Z",
  "paymentMethod": "pix",
  "expiresAt": "2023-11-07T05:31:56Z",
  "copyPaste": "<string>",
  "qrCodeBase64": "<string>",
  "endToEnd": "<string>",
  "notice": "<string>",
  "providerFeeCents": 1,
  "netAmountCents": 1,
  "debitAmountCents": 1001,
  "expectedNetAmountCents": 2,
  "paidAt": "2023-11-07T05:31:56Z",
  "checkoutUrl": "<string>",
  "releaseAt": "2023-11-07T05:31:56Z",
  "cardSettlementStatus": "held",
  "card": {
    "status": "processing",
    "brand": "visa",
    "last4": "<string>",
    "installments": 1,
    "refusedReason": "<string>",
    "attemptsLeft": 1
  }
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

API key criada em Integrações → Keys. Exemplo mk_live_....

Headers

X-Master-Operation

string<uuid>

UUID do negócio selecionado. Sem este header, utiliza a operação principal.

Body

application/json

amountCents

integer

required

Required range: 200 <= x <= 200000

Example:

10000

payerName

string

required

Required string length: 2 - 100

description

string

required

Use string vazia quando não houver descrição

Maximum string length: 200

requestKey

string<uuid>

required

UUID estável para repetir esta mesma cobrança sem duplicar

Response

Cobrança criada ou operação idempotente recuperada

string<uuid>

required

kind

enum<string>

required

Available options:

deposit,

transfer

amountCents

integer

required

status

enum<string>

required

Available options:

draft,

unknown,

pending,

paid,

completed,

failed,

expired,

cancelled

createdAt

string<date-time>

required

operationId

string<uuid>

required

Identificador do negócio

feeCents

integer | null

required

Tarifa da conta registrada na criação

Required range: x >= 0

updatedAt

string<date-time>

required

settledAt

string<date-time> | null

required

paymentMethod

enum<string> | null

required

Available options:

pix,

card,

null

expiresAt

string<date-time> | null

required

Prazo do provedor, null quando não informado

copyPaste

string

Código Pix copia e cola quando fornecido pelo provedor

qrCodeBase64

string

Data URL PNG com QR Code quando fornecida pelo provedor

endToEnd

string

notice

string

providerFeeCents

integer

Tarifa confirmada pelo processamento quando informada

Required range: x >= 0

netAmountCents

integer

Valor líquido confirmado pelo processamento quando informado

Required range: x >= 0

debitAmountCents

integer

Débito bruto do novo saque, com a tarifa da conta incluída

Required range: x >= 1000

expectedNetAmountCents

integer

Líquido previsto do saque ou cartão: valor bruto menos tarifa da conta

Required range: x >= 1

paidAt

string<date-time>

checkoutUrl

string<uri>

Checkout hospedado, somente cartão

releaseAt

string<date-time>

Liberação informada pela liquidante

cardSettlementStatus

enum<string>

Available options:

held,

available

card

object | null

Show child attributes

Conta

Pagamentos

Cobranças Pix

Transferências Pix

Operações de negócio

Cartão de crédito

Criar cobrança Pix

Authorizations

Headers

Body

Response