Create Customer

POST/rpy/be-customer/v1/customers

Request Installment Quotes

This endpoint allows you to create a new customer profile within the Getnet platform. It is primarily used for recurrence scenarios, enabling the association of customer data with future payments such as subscriptions, recurring charges, or tokenized transactions.

Usage Scenarios:
- Associating customer profiles with saved cards or tokenized payments.
- Enabling customer-specific metadata and preferences for personalization and tracking.

Notes:
- The seller_id and customer_id fields are required to uniquely identify the platform and the buyer.
- Detailed personal information is collected including name, document type and number, birth date, and contact info.
-The document_type supports various formats depending on the country (e.g., CPF, CNPJ, DNI_AR, CI_CL, etc.).
-Phone numbers should be provided without mask or formatting.
-An address block can be added optionally for billing or verification purposes.
-Proper validation of document formats and lengths is essential for successful registration.

Body application/json

seller_idstring<uuid>required

ECommerce identification code

customer_idstring

Buyer identifier used by e-commerce. Case be informed it will be passed on in the PIX Payment Notification.

first_namestringrequired

Buyer’s first name.

last_namestringrequired

Buyer’s last name.

Buyer’s document type.

document_numberstringrequired

Buyer’s document number. (without mask)

birth_datestring<YYYY-MM-DD>

Buyer’s date of birth.

phone_numberstring

Buyer’s phone number. (without mask)

cellphone_numberstring

Buyer’s cell phone number. (without mask)

emailstring<email>

Buyer’s email.

observationstring

Notes.

addressany

Set of data referring to the buyer’s address

Response

first_namestring

Buyer’s first name.
Required field for Antifraud

last_namestring

Buyer’s last name.
Required field for Anti-fraud

namestring

Buyer’s full name. Required for ticket.

document_type"CPF" | "CNPJ"

Type of the buyer’s identification document. Mandatory for boleto.

Seed document types here.

Mandatory field for Antifraud

document_numberstring

Purchaser’s document number without punctuation. (without mask)
Required field for Antifraud

emailstring<email>

Buyer’s email.
Required field for Antifraud

phone_numberstring

Buyer’s phone. (without mask)
Required field for Antifraud

billing_addressany

Set of data referring to the buyer’s address

Invalid Requisition

messagestring

Detailed error message.

namestring

Name of the module or system in which the error occurred.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

paymentsobject[]

Error details.

Show payments properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

combined_idstring

combinedId.

order_idstring

orderId.

seller_idstring

sellerId.

Not Found

messagestring

Detailed error message.

namestring

Name of the module or system in which the error occurred.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

paymentsobject[]

Error details.

Show payments properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

combined_idstring

combinedId.

order_idstring

orderId.

seller_idstring

sellerId.

Unprocessable Entity

messagestring

Detailed error message.

namestring

Name of the module or system in which the error occurred.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

paymentsobject[]

Error details.

Show payments properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

combined_idstring

combinedId.

order_idstring

orderId.

seller_idstring

sellerId.

Internal server or service error

messagestring

Detailed error message.

namestring

Name of the module or system in which the error occurred.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

paymentsobject[]

Error details.

Show payments properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

combined_idstring

combinedId.

order_idstring

orderId.

seller_idstring

sellerId.

Bad Gateway

messagestring

Detailed error message.

namestring

Name of the module or system in which the error occurred.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

paymentsobject[]

Error details.

Show payments properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

combined_idstring

combinedId.

order_idstring

orderId.

seller_idstring

sellerId.

Gateway Timeout

messagestring

Detailed error message.

namestring

Name of the module or system in which the error occurred.

status_codeinteger<int32>

HTTP status code of the error.

detailsobject[]

Error details.

Show details properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

paymentsobject[]

Error details.

Show payments properties

statusstring

Error situation.

error_codestring

Error code.

descriptionstring

Description of the error.

description_detailstring

Detailed description of the error.

brandstring

Brand.

payment_idstring

payment_id.

seller_idstring

seller_id.

amountstring

amount.

currencystring

currency.

order_idstring

order_id.

credit_cancelobject

credit_cancel.

Show credit_cancel properties

canceled_atstring

canceledAt.

messagestring

message.

payment_tagstring

payment_tag.

status_codestring

statusCode.

messagestring

message.

namestring

name.

acquirer_transaction_idstring

acquirer_transaction_id.

authorization_codestring

authorization_code.

transaction_idstring

transaction_id.

reason_codestring

reason_code.

reason_messagestring

reason_message.

merchant_advice_codestring

merchant_advice_code.

combined_idstring

combinedId.

order_idstring

orderId.

seller_idstring

sellerId.

curl -X POST "https://api.pre.globalgetnet.com/rpy/be-customer/v1/customers" \ -H "Content-Type: application/json" \ -d '{ "seller_id": "9406df6c-3100-49ba-b4df-d81c1ad8a62b", "customer_id": "string", "first_name": "John", "last_name": "da Silva", "document_type": "CPF", "document_number": "12345678912", "birth_date": "1976-02-21", "phone_number": "5551999887766", "cellphone_number": "5551999887766", "email": "customer@email.com.br", "observation": "The customer is interested in plan x.", "address": { "street": "Av. Brazil", "number": "1000", "complement": "Sala 1", "district": "Sao Geraldo", "city": "Porto Alegre", "state": "RS", "country": "Brazil", "postal_code": "90230060" } }'

const response = await fetch(`https://api.pre.globalgetnet.com/rpy/be-customer/v1/customers`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ "seller_id": "9406df6c-3100-49ba-b4df-d81c1ad8a62b", "customer_id": "string", "first_name": "John", "last_name": "da Silva", "document_type": "CPF", "document_number": "12345678912", "birth_date": "1976-02-21", "phone_number": "5551999887766", "cellphone_number": "5551999887766", "email": "customer@email.com.br", "observation": "The customer is interested in plan x.", "address": { "street": "Av. Brazil", "number": "1000", "complement": "Sala 1", "district": "Sao Geraldo", "city": "Porto Alegre", "state": "RS", "country": "Brazil", "postal_code": "90230060" } }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.pre.globalgetnet.com/rpy/be-customer/v1/customers", json={ "seller_id": "9406df6c-3100-49ba-b4df-d81c1ad8a62b", "customer_id": "string", "first_name": "John", "last_name": "da Silva", "document_type": "CPF", "document_number": "12345678912", "birth_date": "1976-02-21", "phone_number": "5551999887766", "cellphone_number": "5551999887766", "email": "customer@email.com.br", "observation": "The customer is interested in plan x.", "address": { "street": "Av. Brazil", "number": "1000", "complement": "Sala 1", "district": "Sao Geraldo", "city": "Porto Alegre", "state": "RS", "country": "Brazil", "postal_code": "90230060" } }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.pre.globalgetnet.com/rpy/be-customer/v1/customers"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "seller_id": "9406df6c-3100-49ba-b4df-d81c1ad8a62b", "customer_id": "string", "first_name": "John", "last_name": "da Silva", "document_type": "CPF", "document_number": "12345678912", "birth_date": "1976-02-21", "phone_number": "5551999887766", "cellphone_number": "5551999887766", "email": "customer@email.com.br", "observation": "The customer is interested in plan x.", "address": { "street": "Av. Brazil", "number": "1000", "complement": "Sala 1", "district": "Sao Geraldo", "city": "Porto Alegre", "state": "RS", "country": "Brazil", "postal_code": "90230060" } }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.pre.globalgetnet.com/rpy/be-customer/v1/customers", strings.NewReader(`{ "seller_id": "9406df6c-3100-49ba-b4df-d81c1ad8a62b", "customer_id": "string", "first_name": "John", "last_name": "da Silva", "document_type": "CPF", "document_number": "12345678912", "birth_date": "1976-02-21", "phone_number": "5551999887766", "cellphone_number": "5551999887766", "email": "customer@email.com.br", "observation": "The customer is interested in plan x.", "address": { "street": "Av. Brazil", "number": "1000", "complement": "Sala 1", "district": "Sao Geraldo", "city": "Porto Alegre", "state": "RS", "country": "Brazil", "postal_code": "90230060" } }`)) req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.pre.globalgetnet.com/rpy/be-customer/v1/customers")) .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"seller_id\": \"9406df6c-3100-49ba-b4df-d81c1ad8a62b\",\n \"customer_id\": \"string\",\n \"first_name\": \"John\",\n \"last_name\": \"da Silva\",\n \"document_type\": \"CPF\",\n \"document_number\": \"12345678912\",\n \"birth_date\": \"1976-02-21\",\n \"phone_number\": \"5551999887766\",\n \"cellphone_number\": \"5551999887766\",\n \"email\": \"customer@email.com.br\",\n \"observation\": \"The customer is interested in plan x.\",\n \"address\": {\n \"street\": \"Av. Brazil\",\n \"number\": \"1000\",\n \"complement\": \"Sala 1\",\n \"district\": \"Sao Geraldo\",\n \"city\": \"Porto Alegre\",\n \"state\": \"RS\",\n \"country\": \"Brazil\",\n \"postal_code\": \"90230060\"\n }\n}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.pre.globalgetnet.com/rpy/be-customer/v1/customers") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request.body = "{\n \"seller_id\": \"9406df6c-3100-49ba-b4df-d81c1ad8a62b\",\n \"customer_id\": \"string\",\n \"first_name\": \"John\",\n \"last_name\": \"da Silva\",\n \"document_type\": \"CPF\",\n \"document_number\": \"12345678912\",\n \"birth_date\": \"1976-02-21\",\n \"phone_number\": \"5551999887766\",\n \"cellphone_number\": \"5551999887766\",\n \"email\": \"customer@email.com.br\",\n \"observation\": \"The customer is interested in plan x.\",\n \"address\": {\n \"street\": \"Av. Brazil\",\n \"number\": \"1000\",\n \"complement\": \"Sala 1\",\n \"district\": \"Sao Geraldo\",\n \"city\": \"Porto Alegre\",\n \"state\": \"RS\",\n \"country\": \"Brazil\",\n \"postal_code\": \"90230060\"\n }\n}" response = http.request(request) puts response.body

{ "first_name": "John", "last_name": "da Silva", "name": "João da Silva", "document_type": "CPF", "document_number": "12345678912", "email": "customer@email.com.br", "phone_number": "5551999887766", "billing_address": { "street": "Av. Brazil", "number": "1000", "complement": "Sala 1", "district": "Sao Geraldo", "city": "Porto Alegre", "state": "RS", "country": "Brazil", "postal_code": "90230060" } }

{ "message": "string", "name": "string", "status_code": 0, "details": [ { "status": "string", "error_code": "string", "description": "string", "description_detail": "string", "brand": "string", "payment_id": "string", "seller_id": "string", "amount": "string", "currency": "string", "order_id": "string", "credit_cancel": { "canceled_at": "string", "message": "string" }, "payment_tag": "string", "status_code": "string", "message": "string", "name": "string", "acquirer_transaction_id": "string", "authorization_code": "string", "transaction_id": "string", "reason_code": "string", "reason_message": "string", "merchant_advice_code": "string" } ], "payments": [ { "status": "string", "error_code": "string", "description": "string", "description_detail": "string", "brand": "string", "payment_id": "string", "seller_id": "string", "amount": "string", "currency": "string", "order_id": "string", "credit_cancel": { "canceled_at": "string", "message": "string" }, "payment_tag": "string", "status_code": "string", "message": "string", "name": "string", "acquirer_transaction_id": "string", "authorization_code": "string", "transaction_id": "string", "reason_code": "string", "reason_message": "string", "merchant_advice_code": "string" } ], "combined_id": "string", "order_id": "string", "seller_id": "string" }