P2P - transfer to another holder

P2P fund transfer refers to the transfer of funds from a card to an account, followed by a transfer to another account with a different holder, within the SDWO. It is used, for example, to add balance to another person's digital wallet using a branded card (either credit or debit).

See below for an example of a P2P SDWO request:

Request

EnvironmentMethodEndpoint
Sandboxhttps://apisandbox.braspag.com.br/v2/sales/
Productionhttps://api.braspag.com.br/v2/sales/
{
    "MerchantOrderId": "2012345678",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "12345678900",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "CreditCard",
        "Amount": 15700,
        "Installments": 1,
        "SoftDescriptor": "CARTEIRA*NOMELOJA",
        "CreditCard": {
            "CardNumber": "4532110000001234",
            "Holder": "Aline de Souza",
            "Brand": "Visa",
            "SecurityCode": "333",
            "ExpirationDate": "12/2035"
        },
        "Wallet": {
            "PlatformOperator": "ABC",
            "ReceiverData": {
                "Name": "Alan de Souza",
                "Identity": "11122233344",
                "CompanyName": "NOME RAZAO SOCIAL"
            },
            "AdditionalData": {
                "Mcc": "6054",
                "CashIn": true
            }
        }
    }
}

Header parameters

ParameterDescriptionTypeSizeRequired
Content-TypeMedia type accepted by the resource.String40Yes
MerchantIdStore identifier at Cielo.String36Yes
MerchantKeyPublic key for dual authentication at Cielo.String40Yes
RequestIdRequest identifier, used when the store uses different servers for each GET/POST/PUT.String36No

Body parameters

Check the standard credit or debit card request to verify other optional fields. The table below presents the exclusive parameters for P2P SDWO transactions.

ParameterDescriptionTypeSizeRequired?
MerchantOrderIdOrder identification. Can be used to cancel or query the transaction in the future.
Note: Only characters a-z, A-Z, 0-9 are allowed. Special characters and spaces are not permitted.
string50Yes
Customer.NameBuyer's name.
Note: Only characters a-z, A-Z are allowed. Special characters and numbers are not permitted.
string255Yes
Customer.IdentityBuyer's CPF or CNPJ number.text14Yes, if the holder is a legal entity (CNPJ).
Customer.IdentityTypeType of buyer's identification document (CPF/CNPJ).text255Yes, if the holder is a legal entity (CNPJ).
Payment.TypeType of payment method. Default value: CreditCard.string-Yes
Payment.AmountOrder amount (sent in cents).integer15Yes
Payment.InstallmentsNumber of installments. For installment transactions, the number of installments will always be greater than 1.integer2Yes
SoftDescriptorText that will be printed on the cardholder's bank statement. Special characters are not allowed. Must be filled in the format WalletName*merchantname.text13Yes
Payment.CreditCard.CardNumberBuyer's card number.string19Yes
Payment.CreditCard.HolderBuyer's name printed on the card. Special characters or accents are not accepted.string25Yes
Payment.CreditCard.BrandCard brand. Possible values: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.string10Yes
Payment.CreditCard.SecurityCodeSecurity code printed on the back of the card.string4Yes
Payment.CreditCard.ExpirationDateExpiration date printed on the card. Example: MM/YYYY.string7Yes
Payment.Wallet.PlatformOperatorAcronym of the wallet registered at Cielo as a digital wallet (check your acronym with your account manager).string (text)3Yes
Payment.Wallet.ReceiverData.NameName of the receiving customer or establishment.text70Yes
Payment.Wallet.ReceiverData.IdentityCPF or CNPJ number of the receiver.text14Yes
Payment.Wallet.ReceiverData.CompanyNameCorporate name of the receiving establishment.text40Yes, if the receiving customer is a legal entity (CNPJ).
Payment.Wallet.AdditionalData.MccDigital wallet MCC for P2P fund transfer transactions, according to the card brand. See the MCC Table for SDWO Fund Transfer Arrangement.string (numeric)4Yes
Payment.Wallet.AdditionalData.CashInSend as true.boolean-Yes