Sending a Payment Order

The customer will send a Payment Order through an EndPoint in the FitBank API, and the Payment Orders must contain the necessary data for processing and making the payment.

API Method = GeneratePaymentOrder

This method makes it possible to send payment orders. Upon receiving the data sent by the customer, our API creates a beneficiary that initially undergoes a PIX key correspondence check, then the KYC process is carried out and ends with the processing of the transaction to the chosen beneficiary.

{
     "Method": "GeneratePaymentOrder",
     "PartnerId": 30750,
     "BusinessUnitId": 61799,
     "Value": 500,
  	 "Type": 1,
     "Identifier": "7a8b29f5-e73d-4393-b028-62c185e7d9a-00052",
     "PaymentDate": "2022/07/12",
     "Tags": [
          "my payment order 00051",
          "test 00051"
     ],
     "Beneficiary": {
          "Name": "Antonio Wender Lima Marques",
          "Gender": "0",
          "MaritalStatus": "0",
          "Ocuppation": "software developer",
          "Nationality": "BRA",
          "Country": "Brazil",
          "BirthCity": "Fortaleza",
          "BirthState": "Ceará",
          "BirthDate": "2000/07/12",
          "MotherName": "Maria Jose Alves",
          "CompanyType": null,
          "CompanyActivity": null,
          "ConstitutionDate": null,
          "ContactInfo": {
               "Mail": "[email protected]",
               "Phone": "+5585997784745"
          },
          "AccountInfo": {
               "AccountType": 0,
               "ToBankIdentifier":"13203354",   
               "PixKey": "[email protected]",
               "TaxNumber": "08692722354",
               "Bank": "321",
               "BankBranch": "1233",
               "BankAccount": "22222",
               "BankAccountDigit": "0"
          }
     },
     "Payer": {
          "TaxNumber": "83833430000111",
          "Bank": "4123",
          "BankBranch": "56778",
          "BankAccount": "7765",
          "BankAccountDigit": "1"
     }
}

{
  "Success": "true",
  "DocumentNumber": 17841567,
  "Message": "GPO0007 - payment order generated successfully"
}

Description:

Important: To avoid errors and busses in the operation, the PaymentDate field must follow the following format:

If the Payment Order is PIX with bank details, the PaymentDate field must be filled in with the format: 2024-02-16T15:00:00
If the Payment Order is PIX key, the PaymentDate field must be filled in with the format: 2024-02-16

Important: The Type information is optional. If you are not informed, the payment will be automatically processed by PIX.

Important: The information in the ToBankIdentifier field is optional. However, when a PaymentOrder is made using bank details, filling in this field becomes mandatory.

📘

Explanation

NP = Natural Person

LP = Legal Person

Identified Beneficiary = Is the initial step, and will meet most cases, without the need for additional information (is the beneficiary who only needs the information required to settle payment orders)

Qualified Beneficiary = Qualification is a more in-depth step that demands more information about the beneficiary. This step will only be required when, after sending the initial request, the system returns a EXC0033 error. In this situation, a new request must be sent, with the mandatory data for the qualification process (beneficiary who needs to present information previously considered optional for KYC validation)

Pix Key Pattern

By Real Time Payments (PIX)

There are two ways to process the Payment Order by Real Time Payment (PIX) in a quick and efficient way:

Payment Request by PIX key

When sending the Payment Order, the customer needs to inform only the beneficiary's PIX key and TaxNumber (CPF or CNPJ), which can be the CPF/CNPJ number, e-mail, telephone or a random key generated by Brazil's Central Bank (Banco Central). With this data, our API proceeds to verify the correspondence between the PIX key and the payee, then performs the beneficiary's KYC process and concludes the transfer.

Payment Request by PIX with bank informations

When sending the Payment Order, if the beneficiary does not have a PIX key, the customer must inform the beneficiary's bank details and CPF or CNPJ. Having this data, our API verifies if the informed banking data corresponds to one of the institutions that operates with PIX and, if so, proceeds with the transfer.

Payment Request by Wire Transfer (TED)

❗

️ By Wire Transfer (TED)

Expected in v2 Payment Order