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

{
    "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.

Parameter

Description

Type

Size

Required?

MerchantOrderId

Order 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.

string

50

Yes

Customer.Name

Buyer's name.
Note: Only characters a-z, A-Z are allowed. Special characters and numbers are not permitted.

string

255

Yes

Customer.Identity

Buyer's CPF or CNPJ number.

text

14

Yes, if the holder is a legal entity (CNPJ).

Customer.IdentityType

Type of buyer's identification document (CPF/CNPJ).

text

255

Yes, if the holder is a legal entity (CNPJ).

Payment.Type

Type of payment method. Default value: CreditCard.

string

Yes

Payment.Amount

Order amount (sent in cents).

integer

15

Yes

Payment.Installments

Number of installments. For installment transactions, the number of installments will always be greater than 1.

integer

2

Yes

SoftDescriptor

Text that will be printed on the cardholder's bank statement. Special characters are not allowed. Must be filled in the format WalletName*merchantname.

text

13

Yes

Payment.CreditCard.CardNumber

Buyer's card number.

string

19

Yes

Payment.CreditCard.Holder

Buyer's name printed on the card. Special characters or accents are not accepted.

string

25

Yes

Payment.CreditCard.Brand

Card brand. Possible values: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.

string

10

Yes

Payment.CreditCard.SecurityCode

Security code printed on the back of the card.

string

4

Yes

Payment.CreditCard.ExpirationDate

Expiration date printed on the card. Example: MM/YYYY.

string

7

Yes

Payment.Wallet.PlatformOperator

Acronym of the wallet registered at Cielo as a digital wallet (check your acronym with your account manager).

string (text)

3

Yes

Payment.Wallet.ReceiverData.Name

Name of the receiving customer or establishment.

text

70

Yes

Payment.Wallet.ReceiverData.Identity

CPF or CNPJ number of the receiver.

text

14

Yes

Payment.Wallet.ReceiverData.CompanyName

Corporate name of the receiving establishment.

text

40

Yes, if the receiving customer is a legal entity (CNPJ).

Payment.Wallet.AdditionalData.Mcc

Digital wallet MCC for P2P fund transfer transactions, according to the card brand. See the MCC Table for SDWO Fund Transfer Arrangement.

string (numeric)

4

Yes

Payment.Wallet.AdditionalData.CashIn

Send as true.

boolean

Yes